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Int  roduct  ion 

This  document  describes  a  Unix  irn  pie  mentation  of  the 
PLATFCRK  File  Transfer  Protocol  (referred  to*  herein*  as  'The 
Protocol ').  C1 D  Specifically*  this  discusses  the  user-interface 
and  server  codes  prepared  tcr  the  Department  of  Defense. 
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For  the  more  technically  inclined*  further  chapters  cover 
the  internal  relationships  and  expectations  (demands)  of  modules. 
Various  appendices  present  tables*  'help*  databases*  protocol- 
concepts*  examples*  and  implementation  notes. 
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I .   Overview 

The  development  of  computer  networks  has  created  a  need  to 
move  bodies  of  data  between  various  network-linked  sites.  File- 
transfer  programs  address  classes  of  the  non-interactive  demand 
for  this*  and  attempt  to  do  so  in  a  convenient  manner.  The 
Protocols  of  such  codes  must  resolve  the  characteristics  of 
transfers  adequately  so  that  each  site  can  effect  mutually 
comprehended  transformations*  and  such  that  there  is  an  adequate 
recognition  of  the  'success'  or  'failure'  of  each  action. 

The  Protocols  of  PLATFORM  file -transfers  are  based  largely 
on  the  earlier  ARPA-Net  FTP.  The  presumption  of  too  close  a 
correlation*  however*  will  result  in  frustration  and  confusion  — 
despite  the  inevitably  similar  terminology. C2] 

1   Terminology 

A  definition  of  terms  is  in  order  before  progressing: 
ASCII 

The  USASCII  character  set.  In  FTP*  ASCII  characters  are 
defined  to  be  the  lower  half  of  an  eight-bit  code  set  (i.e.* 
the  most  significant  bit  is  zero).  • 

block  mode 

The  standard  PLATFORM  transmission  mode.  The  file  is 
transmitted  as  n  series  of  blocks*  each  terminated  in  an 
EOB*  LFS*  or  EOF.  Each  block  consists  of  one  or  more 
segment  s . 


byte  size 

The  byte  size 
smallest  unit 
data  connection 
of  «.  This  is 
computer's  byte 
content  .    For 


(or   'transfer   byte   size')   reflects   the 


of  data  to  be  transferred  over  the  network 
—  restricted  in  the  Unix  fJCP  to  a  multiple 
a  'convenient'  value*  not  necessarily  cither 
size  ncr  of  any  relationship  to  the  file's 
example:   A   PDP-10  (36-bit  word)  and  PDP-11 

(16-bit  uord)  might  most  conveniently  use  a  72-   or   144-bit 

byte  size. 


data  connection 

A  simplex  connection  over  which  data  is   transferred*   in   a 
specified   byte   size   and   type.   The  path  may  be  between  a 


C 23  Indeed*  this  document  will  plagiarize  definitions 
and  paragraphs  from  the  AEPANfT  PROTOCOL  HANDBOOK*  1976. 
Specifically*  from  RFC  542~(NIC  1 77 59)  "t he ~" f i le~Trans f e r 
Protocol  for  the  ARPA  Network." 
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server-DTP  and  a  user-DTP/  or  between  two  server-DTP  in  a 
three- j. arty  connection.  If  several  data  connections  are 
used  in  parallel  for  one  trans  f.er/  they  are  used  in  round- 
robin  fashion  with  total  disregard  for  any  content  or 
st rue t uri rig  of  the  data.  (That  is*  the  data  is  diverted  to 
the  'next*  connection  every  time  *N*  transfer  bytes  have 
been  sent/  where  N  is  a  FLAT FORM-def i ned  constant.) 

data  sockets 

The  Eassive  DTP  "listens"  on  the  data  sockets  for  RFCs  from 
the  active  DTP  in  order  to  open  the  data  connections.  The 
Server  DTPs  necessarily  have  their  data  sockets  at  fixed 
offsets  from  their  command/reply  sockets.  (■Necessarily1 
because  the  Server's  have  NO  ability  to  inform  another  site 
of  any  variation.)  The  User  DTP  may  or  may  not.  (In  this 
implementation  it  does.) 

data  transfer  process  CDTP3 

The   data   transfer   process   handles   all  aspects   of   the 

transfer   and   the  post-transfer  functions.  Post-processing 

may  not  be  required/-  or  may  be  a  file  copy  or  shell 
initiation.    The   final   act  before  self-extinguishing  is  a 

message  (in  Reply  format)  as  to  the  success  or  failure  of 
its  tasks. 


CFS 


EOB 


EOF 


The  embedded-  f  ',  le-separa  tor  condition  th^t  arises  at  the  end 
of  a  segment  whose  header  has  its  CFS  bit  set.  Systems  not 
supporting  embedded  file  separators  should  ignore  this/ 
except  to  note  the  implied  LSP.  It  is  to  be  ignored  if  it 
coincides  with  an  EOF. 


The  end-of-block  condition  that  arises  at  the  end  of  a 
segment  whose  header  has  its  EOB  bit  set/  or  that  is  implied 
by  an  EFS  or  EOF.  This  term  seems  equivalent  to  end-of- 
recorri   in  more  prosaic  protocols/  but  has  broader  potential 

:«  well. 


The  end-of-file  (-transfer)  condition  that  arises  at  the  end 
of  a  segment  whose  header  has  the  EOF  bit  set.  A  file- 
system  'end  of  file*  on  the  Network  connection  prior  to 
receiving  this  data-condition  indicates  an  invalid/ 
prematurely  terminated  connection  and  not  the  logical  EOF 
state . 


'Foreinn-'  (FTP/  PI/  DTP) 
<Rc?fer  to  *Local-*.> 

'Local-'  (FTP/  PI/  DTP) 


PLATFORM  FTP 
Overview 


A  meaningful  file  transfer  must  involve  two  sites.  At  the 
Protocol  command  level/  each  site  deals  with  the  same 
instruction  set.  but  at  the  higher-level/  Interface  command 
level  the  two  sites  are  distinguished:  the  Local  site  is  the 
'subject'  of  binary  verbs;  the  foreign  site  is  the 
*object'.C33  And  the  Local  site  has  the  acHve  role  —  it 
initiates  data  connections  --  while  the  Foreign  site  is 
E§5sive.  The  terms  originated  from  the  original  two-oarty 
transfers/-  where  the  Local  role  was  played  by  the  User  site 
and  the  Foreign  role  by  the  Network-accessed  one.  Here/-  the 
terms  Local  and  Foreign  had  a  substantive  meaning.  with 
three-party  transfers/  this  distinction  is  not  meaningful: 
both  local  and  Foreign  sites  are  accessed  via  the  Network. 
The  titles/  then/  refer  to  the  roles  and  to  the  relationship 
of  the  site  to  the  positional  arguments  of  binary  commands. 
The  two  alternative  terms  are  User  and  Server/  which  are  NOT 
descriptive  of  the  role/  but  of  the  means  of  access.  The 
User  site  is  the  one  from  which  the  User  Interface  code  is 
being  run. CAD 


LSP 


NVT 


The  use  of  a  logical  separator  point  CLSP3  is  ill-defined  in 
the  Protocol.  It  indicates  an  end-of -re  cord  CF.ORJ  for 
record  structured  transfers.  It  might  also  serve  as  a 
potential  recovery  point  in  future  implementations.  It  is 
indicated  by  any  EOB/  EFS/  or  EOF. 


The  Network  Virtual.  Terminal  as  defined  in  the  ARPANET 
TELNET  Protocol.  AIL  FTP  commands  and  replies  crossing  the 
PLATFORM  Network  are  required  to  correspond  to  the 
constraints  of.  the  NVT.  All  characters  are  in  ASCII  and  all 
lines  are  terminated  in  the  End-Of-Line  (<eol>):  the  two 
ASCII  bytes  <CRXLF>. 


printable  ASCII 
That  subset 
126. 


of  ASCII  ranging  in  value   from   decimal   32   to 


C  3  3  E.g./  a  Local  sit*3  SENDs  to  the  Foreign  site/  and  a 
Local  site  FETCHs  from  a  Foreign  site. 

CAD  This  site  may  be  logically  non-existent.  It  is 
feasible  to  run  the  Servers  without  a  User  Interface  by 
using  Telnet  connections.  Hence/  the  only  context  in  which 
the  "User-"  qualification  has  meaning  relates  to  the 
Interface  code  and  to  its  site. 
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Protocol  commands 

These  are  the  lower-level  commands  which  are  issued  by  the 
User  interface  code  to  the  Pl.t.  5  J  They  are  sent  over  the 
control  connection/'  and  must  be  printable  ASCII.  While  they 
are  specified  to  NOT  have  mixeri-cdse  (upper-  and  lowcr-c.se 
together)  in  one  operator/operand*  this  is  ionored  in  this 
implementation.  Similarly*  they  should  have  one  and  only 
one  space  separating  the  operator  /operands/  but  this  was 
ignored  and  an  arbitrary  number  are  generally  permitted 
anywhere  one  would  be. 


reply 


A  reply  is  an  acknowledgement  (positive  or  negative)  sent  to 
a  user.  The  general  form  of  a  reply  is  a  completion  code 
followed  by  a  text  string.  The  codes  are  used  by  pronrams 
and  the  text  is  usually  intended  for  human  users.  A  multi- 
line reply  begins  with  a  line  bearing  the  appropriate 
three-aigit  code  and  an  immediately  followine  <hyphen>  (*- 
•);  the  terminatinq  line  begins  with  a  repetition  of  the 
three-digit  code  and  an  immediately  following  space;  no 
intervening  lines  may  begin  with  any  three  digit  code. 


segment 

A  segment  is  the  basic  logical  unit  of  dat a-packag inc.  A 
segment  consists  of  a  header  (with  EOF/EOB/EFS  flags  and  a 
data  bit-ccunt)  followed  by  the  implied  quantity  of  data 
(zero-padaed  to  the  next  transfer-byte  boundary  if 
necessary).  The. number  of  bytes  (8-bit)  in  a  header  and 
segment  will  vary  with  the  transfer  byte  size  and  affect  the 
total  number  of  bytes  transferred. 


transfer  byte 

The  smallest  unit  of  data  to  be  transferable   for   the 
It  is  user -defined  and  of  *byte  size*  bits  in  length. 


NCP. 


User-site 

The  User  Site  is  that  network   site   from   which   the   User 

Interface   is   beinq  run*   or  from  which  his  Telnet  control 

connections  originate  to  control  the  Server  FTPs. 


C 5 3  Again*  the  cngnoscenH  may  use  Telnet  connections 
to  issue  these  without  the  u  I  . .  .  thus  practicing  a  form  of 
thaumaturgy  not  to  be  covered  herein. 
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2.2   Data  Transfer  Process  CDTP3 
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nee  the  DTP's  been  launched/  its  PI  may  kill  i 
ses  no  other  control.  The  DTP  opens  its  Nctwor 
tions  and  eventually  returns  (through  its  PI)  a  reply 
ssage  describing  the  success  or  failure  of  the  transf 
ding  file  machinations.  Communications  between  the  D 
arent  PI  is  limited/  c  y  implementation/  to  flags  bein 
completion  of  the  connections  and  for  each  trans 
t)  and  a  completion  message.  The  only  flow  of  c 
a  t  i  o  n  /  then/  is  from  the  DTP  back  to  the  PI.  (Hence 
1  can  'answer*  about  a  running  transfer  is:  "aw 
tions"  or  "<>i>  seaments  t  rans  1  e  rred"  . )  Again/  there 
ction  between  a  User  DTP  or  Server  DTP  running  unde 
entation;  they  are  one  and  the  same  code. 
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In  opening  data  connections  two  roles  must  be  played.  The 
"Foreign"  DTP  must  be  ksssi^e  and  await  "Requests  for  Connection" 
CRFCsD.  The  other/  "Local"  DTP  must  be  active  and  issue  those 
RFCs  to  the  proper  host  and  socket.  In  the  two  party  tr-nsfer/ 
the  User  DTP  plays  the  active  role.  In  three  party  transfers/ 
one  of  the  Server  DTPs  has  the  task  of  mimicking  that  function. 

2-3   User  Interface  [If  ID 


The  Protocol  suggests/  however/  a  higher  level  language  for 
an  "interface  to  oriqinator"  or  user.  This  "suggestion"  and  the 
specified  actions  to  be  effected  in  resoonse  to  the  user  command 
define  the  User  Interface.  It  is  the  Protocol's  intent  that  the 
user  should  be  spared  whatever  actions  can  be  intuited  by  the 
code.  whether  this  'user'  is  an  person  at  a  terminal/  or  another 
executing  process/  or  simply  a  file  of  instructions/  the  goal  is 
to  have  the  FTP  process  arbitrate  details  and  disseminate 
information  on  its  own  to  the  greatest  extent  possible. 
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The  task  of  the  UI*  then*  is  to  control  and  monitor  two  PI. 
The  problem  of  controlling  the  Local  PI  in  a  consistent  mariner 
whether  it  is  a  UPI  or  SPI  is  handled  in  the  UI  by  oeneratinq  UPI 
operands  just  as  it  would  SPI  operands*  but  doing  so  in  a  buffer 
which  the  UPI  treats  as  its  input  buffer.  Inverting  this* 
replies  are  disassembled  from  a  buffer  as  if  they  had  been  read 
in  from  a  file.  This  methoo  permits  the  UI  and  PI  to  run  as  one 
code  --  avoiding  the  shuffling  of  data  through  system  calls  -- 
and  at  the  same  time  permits  the  same  code  to  handle  both  Unix 
UPI  arid  SPI  functions. 

2.4   Server  Initiator  CS 1 3 


The  major  elements  of  the  FTP  model  have  now  been 
identified.  A  miniscule  code  requiring  mention  is  the  Server- 
site  code  tnat  watches  over  Socket  3.  When  it  detects  a 
connection  attempt  thereon*  it  utilizes  the  NCP  to  reserve  a 
socket  setC6D  for  a  recipient  FTP's  purposes*  then  spawns  that 
FTP  with  its  standard  input  and  output  files  directed  to  the 
duplex  Telnet  control  connect ionC Yl  ICP  on  socket  3.  Thus*  the 
one  SI  can  initiate  an  arbitrary  number  of  independent  and 
coextensive  FTPs. 

2.5   Summary 

Ignoring  the  probability  that  various  sites  will  implement 
different   versions  of  this  same  Protocol*  we  could  represent  the 


Insert  FIGURE  1   about  here 
using:  '/*  .so  fiqtf.nroff  or  .so  figtf.troff*  depending  on  the  obviou 


model  with  one  diagram.   This   literally   represents   the   three- 


C63  The  NCP  allocates  an  eight  socket  set  for  the  FTP. 
This  effectively  limits  a  UPI  to  two  parallel  data 
connections*  or  an  SPI  to  three  parallel  data  connections. 
This  is  an  NCP  fixed  allocation  and  isn't  negotiable. 


C  7  3  The  SPI  will  base  its  com m and  and  reply  sockets  on 
offsets  0  and  1  within  the  eight  allocated  by  the  NCP.  It 
will  connect  these  to  offsets  of  3  and  2*  respectively*  from 
the  user-site's  socket  which  connected  to  socket  3.  (The 
user-site  command/ reply  offsets  of  2  and  3*  out  of  a  maximum 
of  7*  explain  Unix  UPl's  limit  to  two  parallel  data 
connect  ions . ) 
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party   connection   scheme;   however/   with   a   minor   coveat  it 

represents   the   loqic  of  the  two-party  interaction  as  well.  The 

caveat  is:  a  User  FTP  supports  the  command  and   reply   paths  via 
internal  buffers/  and  not  by  paths  through  the  file-system. 

A  further  note  is  that  all  of  the  above  functions  (save  the 
SI)  are  effected  by  one  pro. i ram/  forkinq  itself  into  replicates 
that  specialize  their  concerns/  but  share  a  common  text 
(executable  code)  segment  L>,3  :  A  DTP  only  exists  for  the  duration 
of  the  transfer  attempt/  but  it  shares  this  text  for  that  period. 
The  UI  and  UPI  run  as  one  process/  and  differ  from  the  SPI  only 
in  flais  that  are  set  and  files  to  which  they  are  connected;  a 
site  running  both  User  and  Server  FTPs  simultaneously  has  these 
codes  sharing  their  text. 

2.6   Data  Transfer  Functions 
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C81  More  will  be  said  of  this  in  later  technical  notes. 

C93  Anything  passed  back  via  the  Reply  connection  must 
be  guaranteed  to  fit  the  constraints  of  the  reply-form attino 
and  the  NVT.  The  liberties  therein  are  fairly  great/  as 
reflected  in  the  replies  of  the  implemented  HELP  and  STAT 
commands . 


CVjD  The  UNIX  EliQGBAMMPR'S  WANUAL  (Sixth  Edition)/   by 

K.   Thompson   and  D.M. "Ritchie  (Dell  Telephone  Laboratories/ 

Inc.)  is  a  major  reference  on  the  subject/  but  others  should 
be  referred  to  as  well. 
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Several  commands  .ire  concerned  with  aspects  of  the  inter- 
host  data  connections:  BYTE/-  COiJN/  PASV,  and  SOCK.  Another  is 
concerned  with  how  the  data  is  formatted  prior  to  and  after 
transfer:  TYPE.  Certain  functions  that  have  been  optional 
elsewhere  are  fixed  herein:  the  'mode'  is  always  'blocked'/  and 
there  is  no  recognition  of  LBCD1C  character  streams. 

2-6.1   Data  Transfer  Setup 


Before  a  byte  can  be  transferred/-  the  sites   must   agree   on 
the  data  pathways  and  the  characteristics  of  those  paths. 
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C1 13  Refer  to  CONN. 

L123  Currently/-  after  two  minutes. 

C133  Refer  to  PASV. 

C1A3  Currently/-  after  two  minutes. 

C153  Refer  to  SOCK. 


PLATFORV.  FTP 
Overview 


11 


is  a  Local  Server  which  would  normally  presume  that  connections 
were  to  be  offsets  from  whatever  host/socket  was  connected  to  its 
command  socket.  However/  it  is  actually  being  requested  to 
communicate  with  a  third  party  —  another  Server  PI. 

The  sites  at  either  end  of  the  connection  must  also  be  able 
to  deal  with  the  transfer  byte  size.  The  length  attribute  of  a 
network  message  is  in  terms  of  the  number  of  transfer  bytes  in 
it.  This  length  is  specified  in  the  initial  *STR*  ( Host -t o-Hos t 
protocol  message  from  the  Sending  site  To  the  Receiving  site)  and 
is  repeated  in  the  later  H-H  message  headers.  FTP  could  use  a 
connection-open  refusal  from  the  receiver  to  indicate  the 
sender's  transfer  byte  size  was  unacceptable/  but  NCP's  are  not 
generous  in  indicating  the  causes  for  rejection  and  the  cause 
would  probably  have  to  be  inferred.  A  further  problem  mioht  be 
that  the  NCP  would  accept  a  superset  of  the  sizes  that  some  FTPs 
might  accommodate.  The  Protocol  provides  a  method  of  verifying 
acceptance  of  a  specific  byte  size  without  ambiguity  or  waiting 
for  the  attempted  data  connection  opens. C  1  63 

2.6.2   Data  Representation  and  Storage 


In  transferring  the  d3ta  from  one  site's  file  system  onto 
another^  it  is  often  necessary  to  perform  transformations  on  the 
data  because  of  different  data  storage  representations.  This  may 
be  reflected  in  the  different  word  sizes  of  the  systems/  the 
choice  of  different  character  sets/  or  the  sites*  selections  of 
specialized  formatting  based  on  the  data  function.  The  last  case 
is  exemplified  by  those  systems  which  store  printer-destined  data 
in  ASA  carriage  control  format. 

FTP  doesn't  attempt  to  be  the  panacea  for  every  data 
transmogrification.  It  only  recoqnizes  ASCII  and  binary 
representations  of  data/  although  within  the  ASCII  framework  it 
will  format  and  de-format  from   ASA   convent i ons . C 173   Thus/   any 


C163  Refer  to  BYTE.  The  Unix  NCP  is  in  a  critical  stat 
he  of  change  at  this  time.  Historically/  while  the  NCP 
would  accept  any  transfer  byte  size  that's  a  multiple  of 
eiqht  bits/  it  would  apparently  only  send  STRs  for  only 
eight-bit  byte  sizes.  This  would  generally  not  cause  any 
error  if  the  BYTfc  parameter  was  some  larger  multiple  of 
eight.  At  the  moment  of  this  writing  —  February/  1978  -- 
there  hss  been  a  modification  to  correct  the  NCP's  bytesize 
limitation  —  but  it  is  untested. 


C173  As   stated/  the  local  file  system  is  treated  as  if 
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other  representation  must  either  be  extern  .illy  converted  to  ASCII 
or  transferred  in  binary  form.  Unix  systems  support  ASCII  format 
controls/"  if  a  file  is  to  bn  received  or  sent  in  ASA  format/  that 
transformation  is  handled  internally  to  FTP  and  the  Unix  file 
system  will  only  touch  data  with  ASCII  ef f ect ors . C 1 83 

Binary/  or  i^age/  data  is  sent  as  contiguous  bits/  which  for 
transfer   are  packea  into  transfer  bytes  of  the  size  specified  in 


The  receiving  site  must  store  the  data  as 
An  imposed  structure  on  the  data/  such  as 
on  its  storage  system/  may  necessitate  padding 
transfer  byte  boundary  (with  zeroes).  In  all 
of  true  data  in  the  segment  must  be  a  multiple 
of  eight  bits.C193  Image  transfers  require  the  minimum  of 
processing/  and  are  in  that  sense  preferable  for  transfers  of 
most  data  between  like  systems. 
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With  Unix/  file  'structure'  is  considered  to 
of  the  device  through  which  the  file  is  accessed, 
accessed  via  devices  that  generalize  the  file 
blocks  (of  eight-bit  bytes).  Files  are  then  read 
and  the  whole  area  of  file  characteristics  is 
sizes/   record   sizes/   formatting   tricks/   etc. 
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CI  S3  The  supported  ASCII  effectors  are  <CR>/  <LF>/ 
<FF>.  The  use  of  <hT>  are  ignored/  potentially  wreak inu 
havoc  on  some  foreign  sites.  The  supported  ASA  effectors 
are  %+'/  <SP>/  *0'/  and  %1'.  The  use  of  others  will 
generate  warning  flags. 

C1 93  The  problem  in  relaxing  this  restriction  is  the 
unpleasant/  but  feasible  idea  of  having  to  bit-shift  all 
subsequent  data  on  non-record  10  file  writes. 
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files*  or  for  compatibility  with  alien  systems*  there  is  a 
concept  of  the  'raw*  tape  device  --  or  Record  10.  Again*  this 
document  cannot  attempt  to  tutor  t.h  e  ust  on  the  Unix  file 
system;  but  it  should  be  noted  that  'record  structured'  10  is 
only  supported  in  this  implementation  upon  files  mounted  on 
devices  supportinu  it*[203  and  where  no  internal  processing  is 
being  done  (which  might  alter  the  record  sizes). 

2  -7   Class  Act  ions 


The  Protocol  specifications  vaguely  gesture  toward  'classes* 
and  their  value  in  supportinn  printer  output*  tape  handling*  and 
similar  destination-rerouting. 


One  i 
create  or 
society   t 
range  of 
t  ypeset  tin 
FTP  user  a 
—   includ 
user   to 
cardreader 
must  asses 
given   the 
*shel  I '  co 
functions 
for   read* 
per mi  tted/ 
identify  t 
and   overw 
and  will  r 
taken  (app 


mplementati 
receive  the 
his  is  a 
potential 
g*  mi  crof  i  c 
s  it  is  for 
i  n  g  o  p  e  r  a  t  o 
acqui  re  da 
*  sensor-a 
s  its  vu I ne 

g  e  r.  e  r  a  I  i  t 
de  could  (a 
available  t 

write* 
denied  via 
hree  c  I  asse 
rite.  Wri 
equire  succ 
end  or  over 


on  was 

data 
p  o  w  e  r  f 
device 
he*  or 
a  loc 
r  i  nt  e 
ta   f  r 
rray  , 
rabi  I  i 
y   of 
nd  pro 
o  t  he 
delete 

the 
s  of  w 
tten  d 
essf u  t 
lay). 


t  o  pe 
for  a 
ul  too 
s :   qu 

any  o 
a  I  use 
rvent i 
om   an 

digit 
ty  to 

this 
bably 
user. 
*    an 
c I asse 
ri  taol 
at  a  is 

t  rans 


rirnt 
t  ran 
I  fo 
euin 
t  her 
r  . 
on  - 

y  i 

i  zer 
obst 

mec 
shou 

Whi 
d 

s*  t 
e  ac 

a  Is 
f  er 


any 
sfer. 
r    a    r 
g   f  o 

devi 
And* 
-  i  t 
oca  1 1 
*  or 
ruct  i 
h  a  n  i  s 
Id)  b 
le  th 
renam 
he  i  m 
cess: 
o  spe 
bef  or 


pipe 
[213 
emo  t 

r  P 
ce  i 
with 
is  j 

y 

tap 
ve  o 

e  us 
e  sp 
e 

plem 

ere 

ci  f  i 

e  th 


I  ine 
In 
e  us 
lott 
s  as 
pro 
ust 
a  vai 
ed  ri 
r  de 


u 


m 


ed  t 
eci  f 
f  unc 
enta 
ate 
able 
e  fi 


of 
a 
er  w 
ing* 

tr  i 
pe  r 
as  e 
labl 
ve  . 
st  ru 
ore 
o  re 
i  cat 
t  ion 
t  i  on 

on  I 

as 
nal 


program 

benevo 

i  th  a  b 

print 

vial  f o 

int e  r  I 
asy  for 
e    dev 

The  sy 
c  ti  ve 
restric 
strict 
ions  c  a 
s    to 

went  o 
y*  app 
*  i  ndi  re 

ac  t  i  on 


s  to 
lent 
road 
i  n  q  * 

r  an 
oc  ks 

the 
ice: 
stem 
use* 
t  i  ve 

the 
lied 
be 
n  to 
end* 
ct  '* 
i  s 


File-mount  requests  have  their  handles  built 
need  further  code.C223 


into   FT  P   but 


C20D  This   is 
originate   from   a 
transferred   with   Type   set 
information^  refer  to  later 
at t ri  butes  . 


to   say:  the  file  being  transferred  must 
character-type   special   file    and    be 


to    i '  (binary) 
documentation   on 


For  further 
the   'class' 


C213  Refer  to  Class  Actions  in  the  next  chapter. 
C223  This  code  is  to  provided  by  OoD. 


PI AT  FOR*  FTP 
Overv  if w 


H 


Finally/  the  class  specifications  indicate  path 
characteristics  such  as  the  maximum  length  record  for  record-IO 
transfers  —  such  as  tape-to-tape  copies. 
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11.  User  Guide 
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3   User  Interface  CUI3  General  Information 

The  user  interface  code  has  the  responsibilities  of 
providing  a  means  of  establishing  the  control  connection  to 
PLATFORM  FTP  Server  sites*  of  translating  Interface  commands  and 
arguments  into  Protocol  commands  and  arguments/  of  distributing 
PI  commands  and  of  examining  their  reply  codes  in  order  to 
establish  their  success*-  of  breaking  down  user  functions  into 
subcommands  that  must  be  issued*  of  providing  online  assistance 
as  to  the  syntax  of  codes*  and  of  generally  facilitating  the 
broad  scope  of  file  transfers  for  human*  butch  and  process 
•users ' . 


3.1   Command  Lines 

A  command  line  is  limited  to  512  characters.  Furthermore* 
it  is  limited  to  printable  ASCII*  which  may  be  somewhat  of  an 
impediment  to  those  attracted  to  bizarre  filenames  or  improbable 
passwords.    (The   Protocol   stipulates  that  the  PI  cannot  accept 


password^.  vine  rrotocoi  stipulates  tnat  tne  v\  cannot  accept 
anything  but  lines  of  printable  ASCII.)  The  End-Of-Line  C<EOL>D 
for  a  command  line  is  just  the  standard  Unix  <NL>  (ASCII  <LF>). 
The  command  token  must  begin  in  the  first  byte  of   the   line   and 
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runs  until  the  first  <space>  or  <£0L>. 

3.2  Operand  Transformations 

In  a  normal  interaction  the  UI  rarely  has  any  reason  to 
object  to  the  content  of  a  user's  operands/  and  the  user  will 
find  most  error  messaqes  will  arise  from  the  lower  PI  and  regard 
the  content  of  the  operands  as  transformed  by  the  Ul .  It  is 
imperative  that  the  user  understand  this  fact:  In  looking  at  the 
error  message  he  must  consider  what  the  source  of  the  error 
message  was  and/  if  a  PI/  what  the  transformation  was  between  his 
Interface  command  and  the  received  command.  Emphasis  must  be 
placed  on  this  issue  not  because  it  is  arduous/  but  because  it  is 
easily  forcotten  when  one  is  confrontea  with  the  error  reply. 

A  generalization  of  the  operand  manipulations  is:  If  a  field 
of  the  Interface  command  is  required  to  match  'FILE'  or  "IDENTV 
a  decision  will  be  made  between  two  PI  commands  and  the  one 
triggered  by  the  "IDCNT*  will  terminate  in  an  "IV  the  matched 
string  ( *  F 1LE  V  *  IDENT  » )  will  .\0T  be  sent  in  the  PI  operand.  If 
the  Ul  syntax  requires  a  <comma>  (*/')  as  a  separator/  this  will 
be  replaced  by  a  <space>  (*  ')  in  the  PI  operand. 
Transformations  will  be  clearly  spelled  out  for  each  Interface 
command. 

3.3  Command  Abbreviations 


UI  commands   can   be 
leading  substring.   Thus/ 
"RDEF",  but  not  " R"    which' 
are   noted   as   such   in 
command . 


abbreviated  to  the  shortest  unique 
"RDEFINE"  can  be  abbreviated  "RDF.FI"  or 
would  be  ambiguous.  Ambiguous  commands 
their   reply   message/  and  effect  no  PI 


3.4   Local  vs.  Foreign  Commands 

The  Interface  deals  in  general  with  two  PI/  each  of  which 
uses  an  identical  instruction  set.  The  user's  FTP  (or  a  third- 
party/  Server  FTP  if  it  has  been  invoked)  is  known  as  the  Local 
FTP.  Single  site  commands  —  that  might  be  sent  to  either  PI  but 
are  in  the  instance  at  hand  destined  for  the  "Local1  one  --  are 
tagged  with  a  leading  "L*.  The  user  would  use  a  "DEFINE"  for  the 
Foreign  site/  but  would  use  a  "LDEFINC"  for  the  Local  site. 


3.5   Unrecognized  Commands 

If  a  command  is  unrecognized  by  the  Interface/  it  is  sent  on 
to  one  of  the  two  sites  if  there  is  a  connection  to  the  implied 
site.  which  site  to  use  is  inferred  from  the  leading  character: 
If  the  first  character  of  the  command  is  an  *LV  that  byte  is 
stripped  off  and  the  remainder  of  the  line  is  sent  to  the  Local 
PI.   Otherwise/  the  command  line  is  sent  to  the  Foreign  PI.   This 
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is  to  permit  sites  to  implement  additional 
Protoco I  set . 


commands   beyond   the 


The  Protocol  in  fact  stipulates  that  this  should  be  limited 
to  four  character  commands  --  which  is  ignored.  It  is  perhaps 
worth  notiny  that  many  PI  commands  cannot  be  sent  to  the  PI  by 
this  mechanism  as  they  are  in  fact  abbreviations, for  their  UI 
counterparts . 


3.6   Reply  Handling 

Replies  handled  by 
logical   entities:   the 
the  User's  FTP  acting  as 
Server   (acting   as   the 


the   UI   originate   from   one   of   three 

Foreign  Server^  the  User  FTP  (the  UI/  or 

the   Local   PI/DTP)/-   or   a   third-party 

Local   PI/DTP).   To  distinguish  between 


these  sources  of  information/  the  UI  prepends  a  tag-character   as 
the  first  byte  of  each  reply  line.   R espe c ti ve  ly /  these  tags  are: 
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e  arbitrarily  long.  It  is  therefore  the 
NOT  accumulate  an  entire  reply-line  before 
notes  a  reply  becoming  available/-  it  locks 
nnection  (if  it  is  from  the  Network)  until 
at  a  for  some  period  of  time.C23D  It  is 
reply  might  NOT  be  completed  before  the  UI 
er  reoly  sources  --  though  this  has  never 
(An  internal/-  User  FTP  generated  reply 
e  incompletely  copied  out.)  The  indication 
cquired   reply   woulc   be   a  line  in  which 

messages  from  other  sites  would   suddenly 

one  site's  reply. 


3.7   User  FTP  Replies 


In  sending  a  command  to  its  own  PI/  the  UI  assembles  the 
operands  the  same  as  any  remote  PI  would  receive  them.  The 
string  identifying  the  command/  however/  is  usually  left  the  same 
as  seen  oy  the  Interface  (for  obscure  technical  reasons).  The 
result  is  that  'Local*  replies  will  differ  between  a  User  FTP  and 
a  Server  FTP.  For  example/  the  replies  to  a  successful  "LDELETE" 
would  differ  as  follows: 

•User'FTP"-- 250~*ldelete,:~OK  "Loca  l*Se  r\j^r~- 

•*250"'dele,:"OK 


C23D  Currently  one  second. 
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4   Interface  Special  Commands 

The  'flag  commands*  are  those  commands  triggered  by  a  single 
character.   The  only  one  gestured  at  in  the  specifications 
*?•  (Intcrfuce  HELP)  which  it  was   impractical 
suggested.     There   are   three   flag -commands 
options-togqler  ("TOGGLE"). 


is  the 
to  imple  ment  as 
(*/!/?)   and   one 


4.1   Flag  Commands 

4.1.1   **'  —  Comment  Line 

If  a  command  line  begins  with   an   <asterisk>   (***) 
considered  to  be  a  commentary  and  effects  no  PI  actions. 


it 


is 


4.1.2 


i  •  — 


Unix  Escape 


A  command  line  beginning  with  an  <exclam>  ( *  !  '  )  will  result 
in  one  of  two  actions:  If  it  is  followed  by  any  other  characters/ 
these  will  be  executed  as  a  single-line  she  1 1 -escape .  Upon 
completion  of  the  line's  tasks/  the  shell  will  die  and  FTP  will 
print  an  <exclam>  to  indicate  the  termination.  Any  QUIT  or  IfJTR 
signals  (signals  1  or  2)  will  not  effect  the  FTP.  (Exception:  it 
is  possible  for  the  escape  to  have  completed  and  for  the 
character  buffers  to  still  be  emptying  to  one's  terminal;  in  this 
case  the  QUIT  or  1NTR  will  have  fatal  results.) 


If  there  were  no  command  line  characters  after  the  <excl.'im>/ 
the  escape  is  to  an  independent  shell  and  one  will  not  return  to 
FTP  until  the  shell  has  received  an  <EOT>.  Again/  the  return  to 
the  FTP  will  be  heralded  with  an  <exclam>  being  printed. 

In  either  case/  if  replies  should  arrive  from  a  foreign  host 
while  the  user  is  in  a  shell/  the  user  will  NOT  be  informed  --  NO 
FTP-related  information  can  interrupt  the  user's  shell.  The  user 
must  periodically  return  to  FTP  to  ascertain  if  any  expected 
replies  have  arrived. 


4.1.3 


•  t  •  — 


HELP  request 


Both  the  Unix  UI  and  PI  have  means  of  providing  syntax  and 
usage  assistance  for  users.  (The  Pi's  is  used  via  the  "HFLP" 
command/  and  uses  a  different  database.)  In  either  case/  the 
argument  field  is  le f t -deblanked  and  used  as  search-key  into  its 
Help  Library.  This  key  must  match  some  entry/  or  must  be  blank. 
In  the  latter  case/  the  introductory  notes  will  be  displayed  — 
providing  the  instructions  on  its  use.  Only  one  entry  may  be 
searched  for  at  one  tine:  " ?class  id"  will  find  information  only 
on  the  entry  with  the  specified  two  word  title.  No  abbreviations 
are  permissible/  although  case  differences  (UPPER/lower)  are 
irrelevant.   The  HELP  feature  is  intended  to  be  self-instructive/ 
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and   its   database   is  readily  adaptable  to  emphasizing  or  adding 
"features  as  users  express  an  interest  in  them. 

4.2   TOGGLE  —  user  options 

There  are  several  options  within  the  Interface.  Most  were 
implemented  to  "facilitate  its  use  by  Batch  jobs*  but  are 
defaulted  to  states  appropriate  to  interactive  use.  Only  one 
option  may  be  specified  per  command.  Any  number  may  be  specified 
on  the  Unix  invocation  line  for  the  FTP:  they  are  the  only 
acceptable  invocation  arguments  to  FTP.C24J  The  toggle  command 
does  just  that:  the  state  of  the  specified  option  is  logically 
i  nvcr ted. 

4.2.1  TOGGLE  BLOCKED 

If  set/  this  prevents  ANY  commands  from  bein  i  scanned  for 
the  duration  of  a  file  transfer.  Lacking  this*  a  file-driven 
(Batch)  FTP  would  have  all  of  its  pending  commands  flushed  while 
the  first  transfer  progressed.   (Defaulted  RESET.) 

4.2.2  TOGGLE  ECHO 

If  set*  all  but  masked  Interface  command  lines  will  be 
echoed  on  the  standard  output  file.  This  is  useful  if  one  is 
generating  a  trace  1ile  in  which  all  command?  and  responses  are 
listed.   (Defaulted  RESET.) 

4.2.3  TOGGLE  PROMPT 

If  set*  the  UI  will  prompt  the  user  with  a  ":  "  when  the  UI 
is. awaiting  the  next  command.   (Default  SET.) 

4.2.4'  TOGGLE  SUICIDE 

If  set*  the  UI  will  return  an  appropriate  message  ano  commit 
suicide  upon  receiving  an  unacceptable  4xx  or  bxx  reply  code.C25D 


C  2  4  3  At  an  installation  where  the  name 
program  is  "ftp"*  an  invocation  might  look  like: 
ftp  echo  blocked  <eol> 


for  the  FTP 


C253  The  acceptable  ones  are  rare:  a  422  (Abort  Error) 
or  any  error  reply  to  a  CONN'!  In  the  former*  the  reply  may 
be  inherent  in  the  asynchrony  of  the  message  transfers.  In 
the  latter*  it  is  no  real  error  it  a  CONN  is  refused  —  a 
retry  or  default  setting  may  just  be  necessary. 
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A. 2. 5   Other  TOGGLE  parameters... 

There  are    two  other  options  —  "NOREPLI E S"   and   "BATCH" 
which   dre   of   uncertain   value   at  this  time.   There  use  is  not 
recommended/  but  is  harmless.   The  user  is   warned   that   "HATCH" 
sets   the   other  toqgles  as  it  sees  fit;  the  current  settings  are 
too  tentative  to  publish. 

4.3   MAIL  —  Restricted  Access  Mail  Initiator 


The  command  "KAIL  <source  f i le>/< rec i pi ent > "  is  only 
executable  by  "Super  Users".  The  user  is  required  to  be  logged 
onto  (but  not  into  --  see  the  PI  command  "MAIL")  the  desired 
t  arget  site. 

5   Protocol  Interpreter  CPI3  General  Information 

The  Protocol  Interpreter  has  the  responsibility  of  scanning 
PI  commands  for  syntax  errors/  of  processing  all  no n- transfer 
commands/-  of  preparing  transfers  insofar  as  concerns  the  opening 
of  files  or  initiating  shells/-  of  assimilating  status  information 
on  transpiring  transfers/  and  of  transmitting  all  replies  back 
via  the  reply  side  of  the  controlling  Telnet  connection. 

The  commands  cannot  be  abbreviated.  The  case  of  commands  is 
irrelevant/  and  mixed  upper  and  lower  in  a  command  causes  no 
problems  despite  the  Protocol.  Nor  are  <spaces>  treated  as 
critically  as  the  Protocol  insists;  where  one  is  permitted/ 
generally  any  number  may  occur. 


5.1   Protocol  Special  Command 

There  is  only  one  command  implemented  outside 
Protoco I :  HELP 


the   PLATFORM 


5.1.1   HELP 

The  HELP  command  is  implemented  using  the  same  code   as  the 

User   Interface's   "?■   flag -co mm and.    Refer  to  that  section  for 

information  on  its  use.   The   HELP   feature   is   intended   to  be 

self -inst r net i ve/   and   its   database   is   readily   adaptable  to 

emphasizing  or  adding  features  as  users  express   an   interest  in 
t  hem. 


6   Logging  Onto  Other  Sites 

Logging  onto  sites  involves  tour  functions:  establishing  the 
control / reply  connection;  identifying  the  user-id  for  work  on 
that  system;  specifying  the  password  for  that  user-id;  and 
supplying  any  necessary  accounting  information.  The  first  step 
requires  the  establishment  of  a  Telnet   connection   to   a   Server 
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process  via  an  I CP-connect ion  to  its  socket-3.  The  next  three 
steps  are  effected  via  the  Protocol  commands:  USER/  PASS*  and 
ACCT.  A  site  needn't  require  any  'of  the  commands/  but  must  not 
return  an  error  message  just  oecause  the  command  is  irrelevant. 

6.1   UI  Lo 3 gin g  Functions 

All  log-on  functions  are   performed   by   a   single   line   of 
instruction*  as  per  the  specifications. 

6.1.1   LOGOii  (LOGIN)  /  LLOGON  (LLOGIN) 

LOGON 

- —  Attempts  to  effect   the   Foreign   connection   and   user- 
log  in  . 

LLOGON 

Identical  to  LOGON*   but   to   establish   a   third-party* 

Local  site. 

LOGIN 


Identical  to  LOGON. 

LLOGIN 

Identical  to  LLOGON. 


Syntax : 
(L)LOGO 
(L)LOGO 
(L)LOGO 
(L)LOGO 


ICP  socket  . 


N  < host "spec % > 

N  <host*spec,>/'<user''ident> 

N  <host~spec'>*<user~ident>*<password~spec*> 

N  < host "spec ,>*<user~ident>*<password*spec*>*<acct"info> 

<host  s  p  e  c  *  >       ::=  <printable  A  S  C 1 1  > 

or   <prin table  AS  CI I> | <dec i ma  I  #> 

where  * |  '  is  a  flag 

and  <decimal  ti>    is  a  non-standard 

<printable  ASCII> 

<null> 

<pr in  table  ASCII> 
i 

<null> 
where  *!'  prompts  tor  another  line* 

bearing  the  password*  and  attempts 
to  mask  this. 
<acct  info        ::=  <printable  ASCII> 

or      <nul I > 


<user    ident> 
<password    spec ' > 


or 

or 
or 


Use: 

Upon  invoking  User  FTP*  the  user  has  half  of  a  two-party 
connection  complete:  his  implied  Local  site  is  his  User  site  and 
his  access  controls  are  unchanged.  He  must  loo  onto  a  Foreign 
site   (LOGON)*   and   may   wish   to   vary   the  Local  one  (LLOGON). 
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(Acceptable  spell  inq  variations  are  LOGIN /LLOGIN.)  If  the  user 
successfully  logs  in/  his  Unix  working  directory  is  established 
in  the  conventional  manner-  when  '  re-logging  in*  it  is  not 
possible  to  retain  class  definitions  or  redefinitions  that  the 
user  has  made.  (A  regretted  effect  of  certain  presumptions  is 
that  LOGON;  and  LLOGON  can  only  be  used  to  effect  a  connection 
once/  however/  they  can  be  used  to  repeatedly  log  onto  the  same 
site  under  different  access  controls.) 

(L)LOGON  makes  a  connection  attempt  to  the  specified  site 
and/  if  successful/  passes  on  the  specified  fields  with  their 
associated  Server  commands:  USER/  PASS/  e  ••  A  C  C  T  .  Null  fields 
inhibit  the  send  in  g  of  their  Server  command.  (The  distant  site 
must  be  able  to  log  a  user  without  requiring  such  things  as 
nul  l-passwords .) 


The  "  !  ■  option  in   the   password   field   serves   to   protect 
passwords.    If   the  password  field  contains  only  a  *!'/  the  user 
will  be  prompted  for  the  password/   with   the   tty's   echo-option 
inverted.   (On  self  echoing  terminals/  this  will  be  a  problem.) 
Operand  Transformations: 

Fields  are  comma  delimited/  and  have  leadiny  blanks  removed. 

Fields   two   through   four   are  passed/  unmodified/  to  USER/ 

PASS/  and  ACCT/  respectively. 


PI  Reference: 

USER/  PASS 


ACCT 


6.2   PI  Access  Controls 

Access  controls  define  users'  access  privileges  to  the  use 
of  a.  system/  and  to  the  files  of  that  system.  Access  controls 
are  necessary  to  prevent  unauthorized  or  accidental  use  of  files. 
It  is  the  prerogative  of  a  Server-FTP  process  to  provide  access 
control s . 

Three  commands  are  defined  for  generic  access  controls: 
USER/  PASS/  and  ACCT.  Unix  supports  the  first  two/  and  has  a 
'group'  concept  that  bears  similarities  to  ACCT.  Users  have  a 
default  'group*  associated  with  their  user-id/  however/  and 
neither  'group'  changes  nor  ACCT  are    supported  in  FTP. 


6.2.1 
USER 


USER  —  User  Name 

— -  The  command  to  identify  the  desired  username  under  which 
further  work  is  to  be  handled. 


Syntax : 

USER  <user  id> 
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Use: 

Th<?  <User  Id>  is  a  <printable*  ASCII>  string  giving  the 
desired  Unix  username.  If  there  is  no  password  associated  with 
this  account/  the  USER  command  wilt  suffice  to  effect  a  login.  A 
USER  command  may  le  sent  at  any  time  a  transfer  is  not  on  go  inn/ 
and  initiates  a  sequence  of  steps  that  resets  all  previously 
supplied  information  (such  as  class  definitions)  and  may  require 
an  immediately  following  PASS.  A  user  has  a  fixed  number  of 
permissible  loiin  blundersL?6J  /  but  upon  successful  I  oq  i  n  this 
error  count  is  reinitialized.  The  Unix  operating  system  has  a 
"working  directory'  associated  with  each  user  nume/  and  that  will 
be  utilized  for  all  relative  pathnames. 


6.2.2   PASS  —  User  Password 
PASS 

—  a  command   to   supply   the   password 

(necessarily  USER)  command. 


for   the   pr ev  ious 


Syntax : 

PASS  <password> 


Use: 

The  <Password>  is  a  <printable  ASCII>  string  specifying  the 
presumed  password  for  the  immediately-previous ly  given  user  name. 
Failure  to  correctly  specify  a  required  password  requires  one  to 
start  with  the  USER  command  again. 


6.2.3 
ACCT 


ACCT  --  Irrelevent  Command 

-7-~  The  command  (ignored)  to  specify  account  information 
sites  where  this  is  appropriate. 


on 


Syntax : 

ACCT  <anything> 

Use: 


An   irrelevant 
i  gnored . 


command   on   Unix/   which   is   accepted   and 


C  2  6  3  Currently/  six. 
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7   Logqing  Out 

Logging  out  of  a  site  is  accomp.l  i  shed  by  sending  that  site  a 
QUIT  command  or  by  dropping  the  Telnet  cont ro L / rep  I y  connection. 
Either  case  is  rude  if  there  is  an  ongoing  transfer  —  in  which 
case  the  transfer  must  be  dropped. 

7.1   Ul  Logout 

Longing  out  is  accomplished  by  the  Interface  QUIT  command* 
which  is  sent  to  both  the  Local  and  Foreign  site.  The  effect  of 
the  last  stipulation  is  that  any  QUIT  drops  one  out  of  the  FTP 
program*  and  thus  requires  one  to  invoke  FTP  as  many  times  as 
there  are  sites  to  deal  with. 

A  <control  D>  (that  is*  an  <end  of  file>  on  the  UI  standard 
input)  effects  the  same  action  as  a  QUIT  command. 

7-1.1   QUIT  —  A  Request  to  Log  Out  of  Both  Sites 
QUIT 

A  command  to  politely  cease  the  FTP. 

Syntax : 

QUIT 

Use: 

The  QUIT  command  simply  sends  that  command  to  each  site  for 
which  there  is  a  Telnet  connection  open.  The  Server  sites  are 
left  the  task  of  aborting  any  transfers  t hem  selves.  The 
Interface  cede  then  dies.  If  the  Interface  code  seems  hung*  this 
code  is  unlikely  to  free  it  --  the  proper  response  is  to  kill  it 
via  the  Unix  <rubout>  feature. 
PI  Ref e  rence : 

QUIT 


7.2   PI  Logout 

When  the  PI  receives  a  logout  command*  its   response   is   to 

kill   any   slave  *  h  i  c  h  it  has  off  transferring  data  and  then  kill 

itself.    The   identical  action   is   taken   when    the    control 
connection  is  dropped. 

7.2.1   QUIT  —  Logout  Command 
Syntax: 

QUIT 


Use 
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When  the  ouiT  command  is  received/  the  PI  is  to  halt  any 
ongoing  transfer  and  then  cease  execution  itself.  In  the  process 
it  returns  an  appropriate  messane. 

8   C  lass  Act  i  ons 

The  logged-in  user  has  to  deal  with  two  areas  that  will  vary- 
between  different  Operating  Systems:  the  local  filename 
conventions  and  the  class/icient  implementation.  The  former  will/ 
again/  not  be  touched  upon. 

The  class  functions  are  so  vaguely  profiled  in  the  PLATTORM 
specifications  that/  inevitably/  there  will  be  little  or  no 
similarities  between  implementations.  With  no  guides/  and  no 
restrictions/  the  path  taken  was  to  permit  broad  access  to  Unix's 
powerful  command-piping  and  filename  expansion.  These  features 
are  not  for  the  inexperienced  Unix  user  to  play  with  —  they  are 
provided  for  hiahly  manipulative  processing  at  either  end  of  a 
data  transfer.  If  one's  interests  lie  solely  in  simple  tasks 
such  as  file  transfers/  this  section  should  be  unnecessary  beyond 
the  following  paragraph. 

The  Protocol  suggests  that  certain  commands  take  filenames 
for  arguments/  while  others  take  classes  and  idents.  As 
implemented/  those  conmands  taking  filenames  are  in  fact 
processing  the  ccmnvnd  as  if  the  class  name  was  "DEFAULT"  and  the 
ident  was  the  supplied  filename.  The  user  will  occasionally  stir 
up  a  response  that  refers  to  this  implicit  class.  Hopefully/ 
however/  he  will  not  find  it  necessary  to  comprehend  the  breadth 
of  the  class  usage  for  any  of  these  default-class  messages. 

To  use  classes  the  must  be  defined.  The  user  begins  the 
session  with  a  set  already  provided.  There  is  a  bufferC27T 
available  for  user-definitions  or  alteration  of  the  predefined 
ones.  The  logged-in  user  can  ask  the  PI  to  list  the  currently 
defined  ones/  or  can  request  a  description  of  any  particular  one. 
To  differentiate  between  them/  each  has  a  name.  If  a  name  is 
re-used/  on  a  definition  line/  it  will  delete  the  old  definition 
without  comment.  Redefining  the  class  named  "DEFAULT"  will 
affect  all  commands  accepting  filenames  rather  than  class/idents. 

A  class  definition  involves/  then/  a  <class  id>  (the  name  by 
which  that  class  shall  be  referenced)/  and  a  set  of  <keyword 
phrase>s  separated  by  commas.  The  <keyword  p  h  r  a  s  e  >  consists  of  a 
<keyword>  followed  by  an  <ec»ual>  (*  =  ')  and  an  optional  <keyword 
value>.   The  absence  of  a  <keyword  value>  indicates   the   use   of 


1271    Of  500  bytes/  at  this  writing. 
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the  default  value  for  that   <keyword>/   and 
redefinition   of   earlier   values.    (It's 
pointless  on  a  definition  line.) 


is   useful   for   the 
as   harmless  as  it  is 


An  unacceptable  definition  or  redefinition  doesn't  alter  the 
defined  classes.  If  one  of  four  specified  <keyword  phrase>s  is 
incorrect/  all  must  be  repeated.  It  is  illegal  to  repeat  a 
<keyword>  on  any  line:  it  has  but  one  value/  and  the  first 
specified  value  cannot  be  overridden  in  the  same  definition. 

There  are  7  keywords:  recio/  funct/  windr/  mntid/  mntdir/ 
shell/  &  path.  These  may  be  used  in  either  DtH  or  RDCF 
commands/  or  their  User  Interface  surrogates. 

Anytime  they  appear/  they  must  have  an   *  =  •   right -ad j a  cent : 
funct=...        windr=...        and  soforth. 
If  there  is  a  NULL  keyword-value  expression  to  the  riqht  of  this/ 
it  is  an  indication  that  the  default  value  for  that  keyword  is  to 
be  used:  path=/  shell=<eol> 


Keywo 
MNTID 


No  keyword  may  appear  twice  on  a 
rd: 


command  line. 


—  Pr 
keywo 
Ope  ra 
if  a 
insis 
refer 
s  t  r  i  n 
Ope  ra 
provi 
yet.) 


ovided  for  use  with  MOUNT  requests  to  an  Operator/  this 
rd  accepts  a  string  which  is  to  be  displayed  to  the 
tor  to  identify  the  required  devi ce/ volume/whatever . 
*  %  s  *  is  imbedded  in  the  string/  the  code  will  adamantly 
t  that  an  IDEf^T  be  provided  with  any  actionable  CLASS 
ence.    That   IDE NT   will   be   inserted   into  the  MNTID 


q  in  place  of  the 


%s 


as 


it   is   displayed   to   the 


tor.    (This   is   somewhat   hypothetical  as  the  portion 
ding  the  op'-message  interface  has   not   been   received 


HNTDIR 

—  If  a  KNTID  is  provided/  the  nature  of  the  mount  must  be 
declared:  MNTDIR  is  a  boolean  (possible  value  ==  "y"  or  "n") 
which  indicates  if  the  request  is  for  a  directory  (via 
/etc/mount)  or  a  special-tile  (/dev /...).  Whatever  the 
case/  it  is  presumed  the  mount-code  will  place  into  the 
array  'mcuntname*  a  string  indicating  the  pathname: 

"/x"/  "/dev/rmtO"/  "  /dev/  r  k1  "  .'.  . . 

Ex.:    defi  rkroad  .. ./mntdi r=y /mnt i d-rk  pack  09a27/... 

FUNCT 

—  Identifies  the  functions  this  class  will  support.  There 
are  four  basic  categories:  write/  read/  delete/  &  rename. 
There  is  HO  default  FU.\CT/  so  it  must  ALWAYS  be  present  in 
'define';  symmetrically/  it  cannot  be  set  to  any  "default' 
value  via  a  <null>  redefinition  <keyword  value>. 
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C   ==  Create  Only 

For  writing  purposes/1  the  class  is  orUy  creatable:  if 
the  pathname  is  already'  existent/  the  write  will  be 
refused. 

A   ==  Appendable 

Writes  are  supported  by  this  class:  if  the  resultant 
pathname  is  present  the  incoming  data  will  be  appended 
to  the  end  of  it;  otherwise/  the  file  will  be  created. 

W   ==  Writable 

Writes  are  supported  by  this  class:  if  the  pathname  is 
present/  its  previous  contents  will  be  lost. 

**  The  above  three  values  are  mutually  exclusive. 
R   ==  Readable 

This  class  will  support  RETR  and  1NPU.   Ie/  file-system 

reads  are  acceptable. 

D   ==  Deletable 

The  class  will  support  the  DELI  and  DELE  (DELETE) 
command  s . 


N   ==  re-Namable 

The  class  will 
.  command . 


support   the   REiJI   and   RENA   (RENAME) 


The  FUNCT  argument  is/  then  a  string  of  1  to  A  characters 
Ex.:     deti  disk  f unct  =  radn /  . . . 
defi  tape  funct=rw/... 


RECIO 


—  Notes  that  if  'type  i'  and   the   mode -bits   of   the   file 
permit/  record  10  will  be  done.   RECIO  is  the  maximum  number 
of  bytes  per    record.   Jt  must  be  greater  than  zero  and   EVEN 
(in  tribute  to  the  clever  Unix  martape  handlers). 
If  RECIO's  value  equals  zero  (the  default) 

File-system  reads  and  writes  will  be  in  512  byte  blocks 

and  U0  Record  10  will  be  attempted. 

If  RECIO's  value  is  non-zero 

If  the  transfer  type  is  NOT  Image 

(Refer  to  the  TYPE  command  for  an  explanation  of 
the  transfer  types.)  File-syste-n  reads  and  writes 
will  be  in  512  byte  blocks  and  NO  Record  10  will 
be  attempted. 

If  the  transfer  type  IS  Image 

If   the   pathname   doesn't   specify   a    character 

•Special-tile:   File-system   reads   will   be  in  512 

byte   blocks/   ignoring   Record   10;    File-system 
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writes  will  be  in  512  byte  blocks  with  the  3-byte 
header  included.  If  the  pathname  IS  a  character 
special-file:  File- s.y  stem  reads  will  reflect  the 
physical  record-length*  unless  this  is  greater 
than  the  buffer  size/  in  which  case  Unix  will 
traumatize  and  return  an  10  error.  but/  in  case 
you  have  had  the  good  fortune  to  forget:  Unix 
notes  EOF  on  a  raw  magtape  by  returning  an  10 
error  —  an  ambiguous  response! 

File-system  writes  will  reflect  the  Header 
specified  record-length/  unless  this  is  greater 
than  the  buffer  allocation  —  in  which  case  the 
record  will  be  'folded'  and  the  number  of  these 
creases  will  be  noted  at  EOT. 


PATH 


be 
Th 
re 
co 
cr 
in 
pa 
'% 
PA 


The  PATH  is  a  string.   If  it  has  an  imbedded   * %s ' /   this 
11  be  replaced  by  the  IDENT  parameter  --  and  an  IDENT  will 

insisted  upon. 
ere  are  3  uses  for  this  expanded 
quested*   and   onto   a   directory 


ncatenated  to  'mountname'  with  an 


PATH:  If  a  MOUNT  was 
node/   the  PATH  will  be 

intervening  */'...  thus 
If   there   is   no  SHELL 


eating  a  new/  extended  PATH. 
volved/  this  PATH  will  be  considered  to  be  the  local-file 
thhame.  If  a  SHELL  is  involved/  it  may  have  up  to  two 
s*  imbedded/  and  these  will  be  replaced  by  the  extended 
TH;  except  --  see  the  SHELL  keyword. 


WINDR 


IN 

di 

un 
up 
in 
de 
In 
SH 
fo 
cr 
th 


The  WINDR  string  indicates  that  Writes  will  be  performed 
DiRectly.  The  WINDR  string  is/  in  fact/  a  pathname  to  a 
rectory.  The  final  string  of  the  indirect  filename  is 
iquely  generated  and  appended  to  the  WINDR  strino,  Only 
on  the  successful  conclusion  of  the  transfer  is  the 
(iirect  file  concatenated  to  or  written  over  the 
stination  file. 

the  case  of  a  WINDR  specification  coincident  with  a 
ELL/  the  indirect  file  is  NOT  temporary.  It  is  obligatory 
r  the  SHELL  to  see  to  the  indirect  file's  demise.  (This 
eates  the  problem  that  an  aborted  transfer  here  will  leave 
e  indirect  file  about.)  More  on  this  at  SHELL. 


SHELL 


--  The  SHELL  argument  is  a  string  specifying  an  unrestricted 
SH  line.  When  a  SHELL  is  given/  the  FUNCT  specification  can 
only  be  a  solitary  *r'  or  *w'.  If  an  *r'  (read)/  the 
shel  I- invoke r  is  passed  the  extended  PATH/  twice.  Ergo/  it 
may  have  up  to  2  "'/.s*  imbedded.  If  a  '  w  •  (written)/  two 
conditions  must  be  considered:  if  there  is  NO  indirect  file/ 
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the  extended  path  is  passed  twice  --  hence  the  two  'Xs*     are* 


again/  permissible, 
the  first  occurrence 
indirect  filename/ 
"written'  shell  will 
input)  attached  to 
descriptor  one  (the 
"/dev/null". 


However/  if  there  IS  an  indirect  file/ 
of  a  *%s'*  will  be  expanded  by  the 
and  the  second  by  the  extended  PATH.  A 
have  filp  descriptor  zero  (the  standard 

the  start  of  the  data  file;  its  file 
standard   output)    will    point    to 


Other  restrictions  on  keyword  relationships: 


Record  10  and  Indirect-writing   are   incompatible.    If  the 

intent   is  to  sincerely  attempt  Record  10/  the  reasoning  for  this 

is  clear:  the  indirect  files  are  placed  in  a  directory/  and  that 

usually    implies   a   non-re cord   structured   device.    With  the 
addition  of  pseudo-record  10  it  might  be  argued  that  an   indirect 

"file   could   be   supported...   but...   this   would   require  code 
modifications  of  some  sort. 

A  Path  cannot  be  specified  with  a  mounted  non-directory. 
This  reflects  the  fact  that  a  pathname  cannot  be  built  upon  a 
non -directory  base. 

An  Indirect  file  cannot  be  indicated  without  one  of  the 
three  write  functions  being  indicated  ( a | c | w )  .  This  reflects  the 
fact  that  one  of  those  functions  must  exist  to  permit  any  file- 
system  write/  and  the  indirect-files  are  only  an  adjunct  to  such 
writes. 

8.1   UI  Class  Definers 

Unix  FTP  'classes*  are  defined  and  redefined  (modified)  by 
statements  utilizing  the  above  <keyword  phrases>.  These  two 
tasks  are  doubled  by  the  need  to  distinguish  between  the  Local 
and  Foreign  recipients.  In  the  broader  PLATFORM  sense/  however/ 
classes  are  a  site  characteristic  and  the  Interface  command  is 
merely  a  mechanism  of  transporting  whatever  text  is  site- 
requi  red. 

8.1.1   DEFINE  /  LDEFINE  —  Class  Definition 

DEFINE 

- —  The  command  to  define  a  new  CLASS  at  the  Foreign  Site. 

LDfcFINE 

As  above/  but  to  the  Local  Site. 


Syntax : 

(DDEF1NE  <class  id>/<site -specific  class  definition> 
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Use: 

Knovledje  of  the  site-specific  definition  syntax  is  critical 
for   this   command*   which   may  be.  issued  while  logged  in  and  not 
transferring. 
Operand  Trans  format  ions : 

To  senci  this  to  the  site/  the  <comma>  following  the  <class 
id>  is  replaced  with  a  blank.  Forgetting  this  <com:na>  or 
imbedding  a  <blank>  in  the  <class  id>  will  produce  errors  at 
the  Protocol  site. 

PI  Reference: 
DCFI 


8.1.2   RDEFINE  /  LRDEF1NE  —  Class  Definition  Modification 
R DEFINE 

The  command  to  modify  a  CLASS  at  the  Foreign  Site. 

LRDEF1NE 

- —  As  above/  but  to  the  Local  Site. 

Syntax : 

(L)RDEFINE  <class  id>/<site-specific  class  definition> 

Use: 

Knowledge   of   the   site-specific   re-definition   syntax   is 
critical   for   this   conmano/  which  may  be  issued  while  logged  in 
and  not  transferring. 
Operand  Transformations: 

To  send  this  to  the  site/  the  <comna>  following  the  <class 
id>  is  replaced  with  a  blank.  Forgetting  this  <  c  o  m  m  a  >  or 
imbedding  a  <blank>  in  the  <class  id>  will  produce  errors  at 
the  Protocol  site. 

PI  Reference: 
RDtF 


8.1.3   DESCRIBE  /  LDESCRIBE  --  Class  Description  Request 
DESCRIBE 

The  command  to  describe  a  CLASS  at  the  Foreign  Site. 

LDESCRIBE 

As  above/  but  to  the  Local  Site. 

Syntax : 

(L)DfcSCRIbC    <class    id>    (L)DESCRIBE 


Use: 
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This  command  requests  a 
the   specified   class.    The 
standard/  but  induces  a  Unix 
classes. 
Operand  Transformations: 

The  operand  is  unchanged  as  it  is  sent  to 

PI  Peference: 
DESC 


description  of  the  nature  and  use  of 
<null   string>   as   a  class  is  non- 
Pi  to   list   ALL   currently   defined 


the  PI. 


8.2   PI  Class  Definers 

Refer  to  the  earlier  paragraphs   for   a   discussion   of   the 
<keyword  phrases>  used  in  class  definitions. 

8.2.1   DEFI  —  Class  Definition 
DEFI 

— —  The  command  defining  new  classes  and  totally  overwriting 

old  ones. 


Syntax : 


x : 

DEFI  <class  id>  <keyword  phrase>  /  . . .  /-<keywo  rd  phrase> 

<  c I  a  s  s  id>         ::=   a  printable  ASCII  string  with 

no  imbedded  <space>  or  <cornma> 
::=   <keyword>=<keyword  value> 
or    <keyword>  =  <nu 1 1  string> 


<keyword  phrase> 


Use: 


DEFI  defines  a  class  of  the  name  <class  id>  if  there  are  no 
syntax  errors  found.  If  a  class  of  that  name  previously  existed/ 
it  is  overwritten.  The  body  of  the  definition  is  an  arbitrary 
number  of  <keyword  phrases>  separated  by  <comma>s.  No  <keyword> 
may  be  repeated/  and  no  definition  can  be  made  without  the  FUNCT 
keyword  being  included.  Refer  to  sections  above  dealing  with  the 
meaning  and  variety  of  <key*'ord>s. 

8.2.2   RDEF  —  Class  Modification 
RDEF 

- —  The  command  redefining  (modifying)  old  classes. 

Syntax : 

RDEF  <class  id>  <keyword  phrase>/.../<keyword  phrase> 

::=   a  printable  ASCII  string  with 
no  imbedded  <space>  or  <comma> 


<c  lass  i  d> 
<keyword  phrasc> 


or 


<keyword>=<keywerd  value > 
<kcy word>  =  <nu 1 1  string> 


Use: 
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RDEF  modifies  a  class  of  the  name  <clsss  id>  if  thrre  are  no 
syntax  errors/-  if  th^t  class  indeed  exists*  and  if  it  'makes 
sense'.  The  body  of  the  definition  is  an  arbitrary  number  of 
<keyword  phrases>  separated  by  <cofnma>s.  A  <null  s  t  r  i  n  g  >  used  as 
a  <keyword  value >  indicates  that  <keyword>  should  be  returned  to 
its  default  v/alue.  Refer  to  sections  above  dealing  with  the 
meaning  and  variety  of  <keyword>s. 

8.2.3   DESC  -  -  Class  Description  Request 
DESC 

— —  The  command  requesting  a  description  of  a  class. 


Syntax : 

DESC  <class  id> 
DESC 

<class  id> 


:=   a  printable  ASCII  string  with 
no  imbedded  <space>  or  <con;ma> 


Use: 

The  <class  id>  specifies  an  item  for  which  the  user  would 
seek  enlightenment.  If  it  has  been  defined*  the  PI  attempts  to 
shed  some  detailed  light  upon  it.  A  <null  string >  indicates  a 
generally  quizzical  attitude*  and  the  PI  responds  by  simply 
listing  the  currently  defined  classes-  Refer  to  sections  above 
dealing  with  the  meaning  and  variety  of  <key,.,erd>s. 

9   FTP  Data  transformations 

The  user  is  virtually  unlimited  in  his  ability  to  massage 
data  using  SHELL  references  in  the  class  definition  effecting  his 
transfer.  FTP*  however*  recognizes  only  two  transformations 
internally:  NVT  ASCII*  and  NVT  ASCII  with  ASA  printer  formatting. 
Unt rarisf ormed  data  is  called  'binary'*  or  'image1. 

Many  files  can  be  sent  using  any  of  the  three 
transformations/*  the  matter  of  concern  is  that  both  the  sending 
and  the  recieving  site  have  the  same  perception  of  the 
transformation  being  used.  The  least  processing  effort  being 
required  for  an  'image'  transfer*  this  is  generally  preferable 
for  transfers  between  similar  systems-  However*  the  amount  of 
processing  required  in  the  worst  case  should  not  be  overly 
emphasized. 


To  repeat  an  earlier  warning:  there  is  no  universally 
accepted  rule  for  the  transformation  from  ASCII  into  ASCH-with- 
ASA  format  effectors  that  avoids  ambi  juity  in  the  reverse 
transformation.  The  Unix  user  transferring  data  into  another 
Unix  site  will  usually  find  he  has  acquired  'an  extra  <linefeed> 
as  the  first  character  of  his  received  file. 
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9.1   UI  FTP  Transformation  Specification 

The  single  transformation  command  has  three  defined  argument 
values:  A/  1*  and  P.  It  is  possible  for  the  specific  sites  to 
support  a  broader  set;  to  permit  this*  the?  Ul  does  NOT  chtck 
these  argjments. 

9.1.1   TYPh  —  Transfer  Format  Specification 
TYPE 

The  command  to  inform  both  sites  of  the  format  in   which 

data  will  be  transferred. 


Syntax : 

TYPE  I 

TYPE  A 

TYPE  P 


--  Image  format 

—  NVT  ASCII  format 

—  NVT  ASCII  with  ASA  Pr i n t -ef f ect or s 


Use: 

The  TYPE  command  is  a  binary   (two   site)  comirand   that   is 

defaulted   to   "TYPE "A*   unless   a  TYPE  command  has  been  received 

since  the  last  transfer  attempt.    Sites   must  accept   *TYPE"A'. 
(If   either   site   rejects   the   TYPE   spec  i  fie  d  by  the  user/  the 

Interface  will  issue  *TYPE~A*  commands  to  force  agreement.) 
Operand  Transformations: 

The  operand  field  is  passed  on*  unexamined  and  unaltered. 

PI  Reference: 
TYPE 


9.2   PI  FTP  Internal  Transformation 

There   are   three   PLATFORM   defined   TYPEs/  ond      each    is 
supported  on  Unix. 

9.2.1   TYPE  —  Transfer  Format  Specification 

TYPE 

The  command  determining  which  format  the   data   will   be 

transformed  into/out  of  as  it  is  transferred. 


Syntax : 

TYPE  I 

TYPE  A 

TYPE  P 


— -  Image  format 

—  NVT  ASCII  format 

—  NVT  ASCII  with  ASA  Pr i n t -ef f e c to rs 


Use 
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Transfer  Commends 


The  subject  of  transfer  commands  is  broadly  interpreted/ 
here*-  to  incorporate  both  the  data-connection  definition  commands 
and  the  transfer  innitiators. 

10.1   UI  Transfer  Commands 

User  Interface  transfer  initiating  commands  are  single-line 
statements  which  imply  a  number  of  Protocol  commands.  Several  of 
these  commands  set  up  the  path  —  the  number  of  connections  that 
will  be  used/  the  specific  socket/host  for  of  the  Passive  member/ 
which  Protocol  Interpreter  will  in  fact  be  Passive.  The  last  act 
is  to  issue  the  actual  transfer  initiating  commands. 


Additionally/  the  transfer  byte  specification  is  presented. 
This  is  the  one  characteristic  of  the  .Network  data  paths  that  is 
user  definable.  It  represents  the  n.inimum  transfer  unit  for  the 
sites*  fvCPs.[28J  It  is  entirely  an  accommodation  to  NCP's  and 
their  efficiencies  in  transferring  information.  It  has 
bearing  on  the  content  of  the  transferred  data.  The  Unix 
only  handles  multiples  of  S  for  its  BYTE  operand. [293 


to 

no 

NCP 


The  remaining  path-determining  details  are  automatically 
generated  by  the  User  Interface.  The  first  detail  is  the 
arbitration  of  the  CONN  command.  PLATFORM  sites  are  to  permit 
multiple  connections.  The  CONN  operand  is  a  number/  and  if  it  is 
accepted  the  site  presur.es  that  that  number  of  parallel  paths 
will   be   used.    If   it   is   rejected/  another  CONN  value  may  be 


C23  3  Or  it  should.  An  earlier  footnote  indicated  that 
the  Unix  NCP  in  fact  iqnores  this  command.  The  effect  is 
not  a  loss  or  incorrect  interpretation  of  data/  but  a 
potentially  less  efficient  transfer  TO  sites  which  awkwardly 
handle  *BYTE~8'. 


C293  That's  what  it  SHOULD  do/  anyway. 
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attempted*  or  the  value  "1*  can  be  inferred. 

For  a  transfer*  one  site  must  await  the  connection   and   the 

other   site   must   issue   the  connection  initiations.   The  former 

condition  is  forced  upon  a  site   by   the  PASV   instruction;   the 
latter  is  their  default  state. 

The  final  automatically  issued  command  is  sent  only  in 
t  hree-p  .j  rt  y  transfers.  Data  connections  are  normally  offsets  of 
given  amounts  1  ro^n  the  commend/ rep  I  y  Telnet  connection.  In  the 
case  of  the  three- party  transfer*  the  active  site  must  receive 
explicit  instructions  as  the  the  host  and  socket  (via  the  SOCK 
command) . 

10.1.1   BYTE  —  Network  Transfer  Byte  Size 
BYTE 

The  command  to  inform  both  sites  of   the   transfer   byte 

size. 


Syntax : 

BYTE 


<decimal  #> 


Use: 

The  BYTE  command  is  a  binary  (two  site)  command  that  is 
defaulted  to  'BYTE'S'  unless  a  BYTE  command  has  been  received 
since  the  last  transfer  attest.  Sites  must  accept  "BYTE'S*. 
(If  either  site  rejects  the  BYTE  specified  by  the  user*  the 
Interface  will  issue  *BYT-E-~£-''  commands  to  force  agreement.) 
Operand  Transformations: 

The  operand  field  is  passed  on*  unexamined  and  unaltered. 

PI  Reference: 
BYTE 


10.1.2   SEND  /  FETCH  —  Transfer  Initiators 

SEND  /  FETCH 

SE.'mD  ;ind  FETCH  initiate  transfers.    As   their 

have  the  same  syntax*  they  are  discussed  together. 


operands 


Syntax 

SEND 
FETCH 


<Local  t  a  u  >  <Foreign  t  a  i  >  <Local  Spec'>  <Foreign  Spec'> 
<Local  t  a  a  >  <Foreinn  t  a  g  >  <Local  S  p  e  c  '  >  <f  oreiqn  S  p  e  c  '  > 


<Local  tag>  : 
<Local  Spec'> 

<c  lass  id> 


<For ei  gn  t  ag> 


or 


=  <Forcign  Spec'> 


FI  LE 

I D  E  N  T 

::=  <filename> 

or   <  c I  a s  s  id> 

or   <  C I  a s  s  id>*<ident> 
printable  ASCII  string  with 
no  imbedded  <space>  or  <comma> 
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<ident> 


a  printable  ASCII  string  with  no 
imbedded  <space> 


Use: 

If  a  tag  is  "FILE'/  its  Specification  field  is  a  filename  — 
using  the  nan.  in  g  conventions  of  its  site.  If  that  tag  is 
"IDENT**  i ts • Speci f i cat  ion  field  is  determined  by  the  site's 
class  rules.  If  that  class's  definition  requires  an  ident/  then 
it  is  appended  to  the  <class  id>  with  an  intervening  <comma>  and 
no  —  repeat  NO  --  blanks  that  might  be  mistaken  for  a  field- 
separator. 

There  are  two  PI  commands  for  retrieving  data  from  a  Network 
site:  RETR  is  used  with  a  <filename>  data-source;  INPU  is  used 
with  a  <class  ia>  data-source  and*  if  appropriate*  an  <  i  d  e  n  t  >  . 
Similarly*  there  are  two  PI  commands  for  use  with  a  storage 
operation  onto  a  Network  site:  APPE  takes  a  data-destination 
filename;  OUTP  is  used  with  a  destination  <class  id>  and/-  if 
appropriate^  an  <ident>.  The  'appropriateness'  is  determined  by 
the  site's  liturgy  regarding  classes. 


In  a  SEND   operation*   the 
command   is   sent   to  the  Local 
storage  command  is  sent  to  the 
the   LocaL-taq  determined  stora 
and  the  Foreign-tag  determined 
Forei  gn  PI  . 
Operand  Transformations: 

The  operand  is  broken 
<spaces>.  The  operand  s 
.  field:  if  its  tag  was  *IDt 
of  a  <comma>  is  replaced 
is  sent  to  the  Foreign  sit 
tag  is  *  I  DENT*. 
An  Example: 

User  "Command  :  ~~~  send 
To"Local~PI:  " "  re 
Td*Foreign*PI:      ou 


Local-tag   determined   retrieval 

PI  and  the  Foreign-tag  determined 

Foreign  PI.   In  a  FETCH  operation* 

ge  command  is  sent  to  the  Local  PI 

retrieval  command  is  sent   to   the 


into  four  fields  separated  by 
ent  to  the  Local  site  is  the  third 
NT'*  the  first  (if  any)  occurrence 
with  a  <  s  p  a  c  e  >  .  The  fourth  field 
e  t    with  similar   handlina   if   its 


lii§  ident  alph 
t r  a Ip  ha 
t_Q  beta  gamma 


beta* gam ma 


PI  Ref e  rence : 

CO'N,  PASV* 


SOCK*  f-PPE*  RETR*  OUTP*  INPU 


10.2   PI  Transfer  Data  Connection  Modifiers 


There  are  four  commands   setting   NCP   or   purely   data-path 
related  matters:  tiYTE,  CONN*  PASV*  and  SOCK. 
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10.2.1  BYTE  —  Network  Transfer  Byte  Size 
BYTt 

---  The  command  to  specify  the  transfer  byte  size. 

Syntax : 

BYTt   <decimal  ff> 

Use: 

The  BYTE  command  has  a  generic  range  of  1  to  2  5  5  •  and  a 
specific  Unix  limit  to  multiples  of  8.  Other  values  will 
generate  error  messages.  Its  value  is  defaulted  to  *8*  unless  a 
BYTE  command  has  been  received  since  the  last  transfer  attempt. 
Sites  must  accept  *  B  Y  T  E  ~  8  '  . 

10.2.2  CONN  —  Parallel  Connections  Arbitration 
CONN 

The   command   to   specify   the    number    of    parallel 

connections. 

Syntax : 

CONN   <decimal  U> 

Use: 

The  CONN  command  has  a  generic  range  of  1  to  3.C303  Other 
values  will  generate  errot  fi.essages.  Its  </alue  is  defaulted  to 
" 1  •  unless  a  CONN  command  has  been  received  since  the  last 
transfer  attempt. 

10.2.3  PASV  —  Establishing  the  Passive  Role 
PASV 

The  command  to  force  the  site  to  await  data   connections 

rather  than  initiate  them. 

Syntax: 

PASV 

Use: 

Since  only  one  site  can  be  active*  the  other  must  be  sent  a 
PASV  command  so  that  it  will  await  the  RFCs.  A  Pi's  natural  Pent 
is  to  actively  send  the  *RFC's  that  initiate  a  connection... 
which  it  will  do  upon  receipt  of  a  transfer  initiating  command 
unless  it  has  received  a  PASV  since  the  last  transfer  attempt. 


C  3 ' .  3  A   Unix   NCP   implementation    limits 
Interface's  PI  to  only  two  parallel  connections 


the 


User 
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10. 2. A   SOCK  —  Redirecting  Traffic 

SOCK 

The  command  to  force  the   site   to   use   an   alternative 

data-socket  base  if  it  initiates  the  next  data  connections. 


Syntax : 

SOCK 


<decimat  host  tf>      <decimal  socket  P> 


Use: 

If  the  PI  is  active  upon  receipt  of  the  next  transfer 
initiating  command*  and  it  is  NOT  to  use  the  standard  data 
sockets/  this  is  the  mechanism  for  resetting  the  socket  base. 
The  socket  base  is  reset  to  the  default  after  each  transfer 
attempt  . 

10-3   PI  Transfer  Initiators 

There  are  two  directions  a  Protocol  Interpreter  can  ship 
data*  and  two  modes  --  by  filename  and  by  class/ident.  To 
simplify  the  functioning  of  the  Plr  the  filename  version  is 
mapped  directly  into  a  class/ident  pair*  where  the  class  is  named 
"DEFAULT"  and  the  ident  is  simply  the  filename. 
Ex  amp le : 

Retr'the/ba 11 

•..*is"processed*by"exactly"the"same"codes*as: 

Inpu"Default*the/ball 

This  internal  transformation  is  of  little  concern  to  the  user 
beyond  its  impact  on  the  wording  of  error  messages  or  the  risks 
engendered  by  redefining  the  class  "DEFAULT". 

There  is  no  assurance  of  effecting  a  transfer  just  on  the 
basis'  of  the  request.  The  syntax  is  simple*  but  if  a  class  is 
referenced  its  syntax  is  also  rechecked  and  the  whole  must  be 
found  to  be  consistent.  Then  the  file-systeT  must  support  any 
file  references*  or  any  shell  initiations. C31D  Finally*  the  Data 
Transfer  program*  with  all  the  above  initialization  already 
handled  by  the  PI*  is  spawned.  It  will  first  tackle  opening  the 
Network  data  connections  and  then  go  about  the  oat  a  manipulations 
and  transfer.  It  may  well  encounter  inconsistent  data*  or 
t  ransf e  r  errors. 


C  3 1  3  There  is  currently  NO  test  imbedded  as  to  whether 
the  shell  did  indeed  successfully  initiate.  The  failure  of 
this  will  (probably!)  be  indicated  by  a  failure  on  the  first 
file-system  read /write. 
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Regardless*  at  the  conclusion  of  attempting  this  transfer/ 
for  better  or  for  worse/  the  variety  of  parameters  are  reset  to 
their  default  values. 

10.3.1   RETR  /  INPU  --  File  System  Read 
RETR  /  INPU 

These  commands  transfer  data  from  the  local   file-system 

onto  t  fie  Network  . 


Syntax : 

RETR' 
INPU" 
INPU' 


<f i  lename> 
<c I  ass*  i  d> 
<class~id>*<ident> 


Use: 

The  use  of  the  IMP'J  command  requires  the  <class  id>.  The 
specific  <class  id>  definition  may  or  may  not  require  the  <ident> 
field. 

10.3.?   APPE  /  OUTP  —  File  System  Writes 
APPE  /  OUTP 

These  commands  transfer  data  onto  the  local   file-system 

from  the  Network. 


Syntax  : 

APPE 
OUTP 
OUTP 


<f i  lename> 
<c  las  s" i  d> 
<c lass" id> 


<ident> 


Use 


The  use  of  the  OUTP  command  requires  the  <class 
specific  <class  id>  definition  may  or  may  not  require 
field. 


id>.    The 

the  <  i  den t> 


11   Transfer  Termination 

Termination  of  an  ongoing  transfer  can  be  a  deliberate  user 
action  as  well  as  the  incidental  result  of  dropped  connections/ 
erroneous  data/  or  file-system  problems.  It  was  earlier  noted 
the  QUIT  command  will  force  a  termination  of  ongoing  transfers. 
There  are/  however/  the  more  straightforward  procedures  of  the 
abort  codes. 


11.1   UI  Transfer -Aborting 

The  Interface  instruction  effecting  a  mid-transfer  (or 
connection)  abandonment  of  a  t r ans f er -at t empt  is  AbORT. 


mid- 
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11.1.1   ABORT  —  Terminate  Any  Ongoing  Data  Traffic 

ABORT 

--t  A  command  to  kill  the  Data  Transfer  Process  while  it   is 
awaiting  Network  connection  completion  or  transferring  data. 

Syntax: 

ABORT 

Use: 


The  ABURT  command  will  issue  an  ABOR  instruction  to  each  PI. 
(This  is  done  without  respect  to  the  presumed-s ta t e  of  the  PI  as 
this  function/  more  than  any  other/  is  necessary  to  recover  from 
'trouble'.  Should  the  UI  incorrectly  interpret  the  state  of  the 
subservient  PIS/  this  command  may  yet  permit  them  to  re- 
synchronize.)  It  is  technically  an  error 
sent  t o  a  site  which  is  NOT  transferrin g  ; 
commands  traversing  the  net  makes  it 
apparently  legitimate  At  OR  to  be  improper 
receipt.  For  this  reason/  error  responses 
not  taken  seriously  by  the  UI. 
PI  Reference : 

ABOR 


for  this 
however/ 
possible 
by   the 


comma  nd  to  be 
the  I  c ■}  of 
for   even  an 

time   of   its 


to  an  abort  effort  are 


11.2   PI  Abort  Processing 


ABOR 


11.2.1   ABOR  —  Terminate  Data  Transfer 

- —  A  command  to  kill  the  process   effecting 
and  to  reset  all  values  to  their  defaults. 


any   transfer/ 


Syntax: 

ABOR 

Use: 

The  ABOR  command  is  implemented  to  halt  any  ongoing  transfer 
and  to  reset  parameters  to  their  defaults.  (It  will  NOT  effect 
class  definitions/  but  wil  reset  TYPfc/  BYTE/  CONN/  PASV/  etc.) 


12   File  System  Utilities 

The  utility  functions  of  the  PI  codes  are  simply  the  rename 
and  delete  features.  To  execute  these/  the  user  must  have  access 
privileges  to  the  file.  If  the  file  is  accessed  via  a  <  c I  a  s  s 
id>/  then  on  Unix  that  class  must  be  functionally  enabled  for  the 
specific  operation.  (Refer  to  "timet*  in  the  class-usage 
instructions.) 


PLATFORM  FTP 
User  Guide 


41 


Furthermore/  the  user  has  unlimited  acccs  to  his  User  site's 
Unix  via  the  'escape*  f  lag-commands . 

12.1   UI  Utility  Commands 

12.1.1   RENAME  /  L RENAME  —  File  Renaming 
RENAME 

This  command  attempts   a   file   rename   on 

fi lesystem. 


the   Foreign 


L RENAME 

As  RENAME/  but  on  the  Local  file-system. 

Syntax : 

(L)RENAME"FlLE~"<oldfilename>/<newfilename> 

(L) RENAME  "IDENT"<class~id>/<oldident>/<newident> 

Use: 

This  command  instructs  the  specified  site  to  rename  the  file 
which   has   been   identified.    The   use   of   classes   requires  a 
knowledge  of  the  specific  site's  approach  to  these. 
Operand  Transformations: 

The  second  operand  field  is  broken  into  the  appropriate 
number  of  subfields  (as  indicated  by  the  first  operand) 
using  the  <comma>s.  These  <co;nma>s  are  replaced  by 
<space>S/  and  the  doublet  or  triplet  is  passed  en  to  the 
proper  PI  . 

PI  Reference: 

REM/  RE  MA. 


12.1.2   DELETE  /  LDELETE  —  File  Deletion 
DELETE 

This  command  attempts  a  file   deletion   on   the   Foreign 

fi lesystem. 

LDELETE 

As  DELETE/  but  on  the  Local  file-system. 

Syntax : 

(L)DELETE"FILE"*<filenome> 
(L)DELtTE~lDENT~<class~id>/<ident> 


Use: 

This  command  instructs  the  specified  site  to  delete  the  file 
which  has  been  identifies.  The  use  of  classes  requires  a 
knowledge  of  the  specific  site*s  approach  to  these.  The  need  for 
an  ident  with  the  class  is  determined  by  the  class  definition  and 
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site's  rules. 

Operand  Transformations: 

The  second  operand  field   is   broken   into   the   appropriate 

number   of  subfields   (as   indicated   by  the  first  operand) 

using   the  <comma>s.    These   <comma>s  are          replaced    by 

<space>sr  and   and   the  second  argument  is  sent  on  with  the 

associated  PI  command. 

PI  Reference: 

DELI/  DELE. 


12.2   PI  Utility  Codes 

The  utility  functions  of  the  Unix  PI  are  file  renaming  and 
deletion.  The  mechanism  used  for  renaming  is  a  full  file-copying 
under  the  new  name...  a  gross,  techni que . 

12.2.1   RENI  /  RENA  —  File  System  Rename 
RENI 

A   command   to   rename    a    file    using    class/ident 

information. 


RENA 


A  command  to  rename  a  fite  using  its  filename. 


Syntax. 

REtfA*<ti lename> 
RENI~<class*id> 
RENI"<class"id>*<ident> 

Use: 

The  file  renaming  commands  result  in  an  attempted  copying  of 
the  specified  file/  and  a  removal  of  the  original.  The  first 
requirement  is  that  the  named  new  entry  doesn't  exist...  a 
paternalistic  and  arbitrary  implementation  decision.  The  next/ 
that  the  new  file  may  in  fact  be  created.  Then/  there  must  in 
fact  be  room  for  the  new  copy  to  cohabit  with  the  old  —  for  the 
chosen  algorithm  is  indeed  a  file  copying  one.  And  finally/  the 
original  file  must  be  removable.  A  failure  of  any  step  will 
produce  an  error  message  and  things  will  be  reset  to  the  original 
state . 

12.2.2   DELI  /  DELE  --  File  System  Delete 
DhLI 

A   command   to   delete    a    file    using    cl3ss/ident 

inf ormot ion. 


DCLA 


---  A  command  to  delete  a  file  using  its  filename. 
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Syntax: 

DELE"<f i  lename> 
DELI~<class" id> 
DELl"<class"id>"<ident> 

Use: 

These  commands  attempt  the  obvious.   The  requirement  for   an 
ident  field  is  purely  class-definition  dependent. 

13   Mi  s  eel  I  any- 
Then  there  are  the  other  commands.... 
13-1   UI  Misc. 

13.1.1   STATUS  /  LSTATUS  /  USTATUS  —  PI  (UI)  Status  Request 
STATUS 

The  command   to   request   a   self   assessment   from   the 

Foreign  PI. 

LSTATUS 

As  STATUS*  but  for  the  Local  PI. 

USTATUS 

Requests  information  from  the  User  (Local)  PI  is   a   two 

party  environment/-  or  from  the  UI  in  a  three  party. 

Syntax  : 

STATUS 

STATUS  <pathname> 

LSTATUS 

LSTATUS  <pathname> 

USTATUS 

USTATUS  <pathname> 

Use: 

There  are  two  classes  of  status  request:  wi^th  ?nd  b'iitl(jyt  a 
pathname.  The  former  is  an  implementation  decision  on  the  Unix 
FTP.  If  no  pathname  is  supplied/  the  appropriate  PI  is  sent  a 
STAT  command  --  the  UI  uses  its  own  PI  even  in  a  three  party 
situation  to  provide  its  details.  To  use  the  <pathname>  feature 
with  a  no n -Unix  site  is  a  violation  of  the  Protocol. 
Operand  Transformations: 

If  an  operand  is  there*  it  is  passed  intact. 

PI  Ref e  rences : 
STAT. 
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13.1-2   FPASSWORD  (FMPASSWORO)  /  LFPASSWORD  ( LFMPASS WOK D) 
FPASSWORD 

---  Sends  an  access  control  File   Password   to   the   Foreign 

site. 

LFPASSWORD 

As  FPASSWORD/  hut  to  the  Local  site. 

FMPASSWGRD 

- —  As  FPASSWORD^   but   it   prompts   for   the   password   and 
attempts  to  mask  it. 

LFMPASSWORD 

As  LFPASSWORD/  but   it   prompts   for   the   password   and 

attempts  to  mask  it. 

Syntax: 

FP ASS  WORD    <file  r  a  s  s  wo  rd  > 
LFPASSWORD"*<1 i le  password> 
FMPASSWORD 
LFMPASSWORD 

Use: 

File  passwords  are  not  used  on  Unix  systems/  but  the  command 
is  supported  for  others'  benefit.  The  two  versions  with,  operands 
are  the  suggested  version/  but  indicate  little  consideration  for 
the  intimacy  of  passwords!  The  two  lacking  operands  return  with 
a  request  for  the  user  to  supply  them  on  the  next  line; 
meanwhile/  the  echo-option  of  the  tty  is  inverted  --  which  may 
have  non -beneficial  results  on  some  terminals. 
Operand  Transformations: 

None  are  performed/  and  the  operand  is  shipped  as  received. 

PI  Ref e  rencts: 
FPAS. 


13.2   PT  Miscel lany 

13.2.1   NOOP  —  A  Null-Command 
NOOP 

Does  nothing  but  return  with  an  *0K'  reply- 
Syntax  : 

NOOP 


Use 
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Your  guess.   It  could  be  used  to  indicate  the  responsiveness 
of  the  receiv/iny  site. 

13.2.1.1   STAT  —  Status  Request 
STAT 

Returns  status  information  or  filesystem  info1. 

Syntax : 

STAT 
.  STAT  <pathname> 


Use: 

The  STAT  without  an  operand  returns  the  values  of  the  user- 
settable  parameters/1  the  command  state  of  the  PI/  and  the  number 
of  PLATFCRM  segments  processed  if  a  transfer  is  ongoing.  If  an 
operand  is  suprlied/  the  user  is  logged  in/  and  no  transfer  is  in 
progress  it  will  instead  use  the  operand  as  a  pathname  and  will 
provide  file-system  information  on  that  pathname. 


13.2.2   FPAS  —  Irrelevent  command 
FPAS 

---  A  command  to  supply   the   file-associated 

access-control  purposes. 


password   for 


Syntax 

FPAS  <printable  ASCII> 

Use: 

This  command  is  ignored  by  the  PI  as   Unix   has   no   defined 
implementation  of  File  Passwords. 

13.2.3   MAIL  —  Mail  Receipt  Command 
MAIL 

---  A  command  to  initiate  a  mail -depositing  transfer  without 
the  user  logging  in. 


Syntax 

MAIL 


<recipi  ent > 


Use 


control  connection. 
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Notes 


III. Installation  Notes 

The  following  .ire  intended  to  cover  the  tasks  associated  with  the 
installation  ot  the  PLATFORM  File  Transfer  codes  on  a  Unix 
installation.  The  reader  is  presumed  to  be  a  proficient  Unix 
programmer  with  an  understand  inn  of  the  various  compiler  options/ 
loading  and/  to  a  lesser  extent/  his  site's  relationship  to  the 
PLATFORM  Network  (...  its  site-name/  etc.). 

1   Defines-file  Changes 

The  defines  file  for  compiling  has  a  number  of  entries  that 
are  either  discretionary  changes  or  mandatory.  The  changable 
values  of  the  define  file  (pldef.h)  are  collected  at  its  top  and 
are  clearly  demarcated.  The  important  ones  will  be  discussed 
below : 

HOSTID 

Your  network  hostname/  as  it  is  used  in  certain  replies. 
Example:  "ill-nts". 

PASSWD 

This  is  the  name  of  the  system's  password  file/  and  is   used 
by  the  server  PI  for  logging  in  users. 
Example:   "/et c /passwd". 

DUMPMSG 

This  file's  presence  indicates  that  system  access  is 
restricted/  and  contains  a  text  explanation  of  the  cause 
and/or  expected  duration.  This  name  should  never  be  null 
("")  as  Unix  believes  it  exists  and  login  will  be  prevented! 
Example:  "/et c /dumpmsg". 

DATA SHE  LI 

This  is  the  shell  program  handling  data-transfer  shells. 
(That  is/  the  shell  handling  the  use r-s pe c i 1 i ed  pipeline  or 
postprocessor.)  The  site  must  consider  the  eventual  need  to 
use  a  in odified  shell  to  restrict  the  powers  of  the  user 
community  ! 
Example:  M/bin/sh". 


YOUR.LS 

Generally  M/bin/ls".. 
"/bin/lz"  is  used. 


however/  at  CAC  an   enhanced   version 


YOUR_LS_PARMS 

This  is  the  parameter  used  with  a  Y0UR_LS  call:  for  Is 
calls/  it  would  usually  be  "-1" ;  for  iz  calls/  it  might  be 
"-lg". 

HELPPROG 
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A  HELP  program  (supplied  with  FTP)  which  finds  an  arbitrary 
number  of  'paragraphs*  and  prints  them  on  the  standard 
output.  The  first  r-arameter  is  the  filename  of  the 
information  file*  and  the  remaining*  aritrary  numt.er  of 
arguments  are  search  strings  applied  to  the  paragraph  titles 
of  this  file.  The  define  value  is  the  pathname  of  this 
program. 


SRVMELPTXT 

The  value  here  is  the  pathname  of  the  text   file 
HELPPROG  for  answering  Server-FTP  inquiries. 


used   with 


USRHELPTXT 

The  value  here  is  the  pathname  of  the  text 
HELPPROG  for  answering  User-FTP  inquiries. 


file   us  ed   with 


ACTIONSTRIN'G 

This  is  a  text  string  which  is  attached  to  the  'restricted- 
access'  message/-  and  indicates  a  locally  appropriate  action. 
Example:   "The  Operator  may  be  reached  at  217-555-12  34." 

ICPSOCKET 

This  Volue  is  used  by  the  User  Interface  when  it  attempts   a 
connection  to  s  Server  1CP  socket.   Eventually*  PLATFORM  FTP 
is   to   run   off   socket   3*   but   during   testing    periods 
experimental  sockets  may  be  used. 
Ex  amp  I e :   11 

The  above  would  attempt  to  connect  to  socket  (decimal)  11  of 
'  the  Server  site  when  a  LOGON  is  executed. 

CLASSROOM 

The  number  of  bytes   available   for   user-additions   to   the 
initially   defined   classes.    (This   will   be   increased  or 
diminished  by  any  redefinitions  of  those  --  it  is  simply  the 
number  of  unused  bytes  in  the  end  of  the  definition  area. 
Ex  amp  I e :   500 

The  above  allocation  of  500  bytes  is  arbitrary...  only 
experience  will  indicate  a  reasonable  number  to  allocate. 

CLASSINFOSZ 

This  number  indicates  the  amount  of  space  to  be  permitted  in 
the  generation  of  a  class-definition  'line*.  New 
definitions  must  be  less  than  this  many  bytes  in  length*  and 
redefinitions  must  result  in  a  line  of  less  than  this  many 
bytes.  The  size  is  arbitrary*  and  effects  only  temporary 
stack  allocations. 


MSGALLOC 

This  is  imbedded  in  the  Network  file  open  descriptor*  and 
indicates  the  size  of  the  buffer  space  you  wish  Unix  to 
allocate  when  reading  data  from  the  net.   A   number   smaller 
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th.in  2042  will  probably  slow  down  the  transfer  rate 
somewhat/  and  a  larger  value  will  probably  exhaust  the 
system  buf  f e  r s . 


KAXPATHSIZE 

This  value  indicates  the   maximum 
permitted  for  a  pathname. 


number   of   bytes   to   tie 


MAXKOUNTNAttE 

This  vjlue  indicates  the   maximum   number   of   bytes   to  be 

permitted   for   a  mount-file  name  (ie/  a  special  file  or  the 

pathname  to  an    inode  on  which  a   directory   system   will  be 

mounted).  As  this  is  to  be  implemented  elsewhere/  the 
reasonable  size  is  someone  elses  problem! 

SHELLTXTBFRSZ 

This  is  the  size  of  the  buffer  to  be  allocated  to  generating 
EXECL  lines.  It  must  be  greater  than  MAXPATHSIZE/  and 
should  probably  by  256  or  greater. 

CONNTIMEOUT 

This  value  indicates  the  length  of  time  to  be  permitted 
before  a  non-responsive  connection  attempt  is  discarded. 

MAXLOGTRIES 

This  is  number  of  unsuccessful/  consecutive  login  attempts 
which  will  be  considered  fatal.  When  this  many  occur/  the 
Server  PI  *i 1 1  drop  the  command/ rep ly  connections. 


2   FTP  Compilation 

The  FTP  codes  are  all  written  in  *  C  * .  The  compiler  used  to 
develop  them  is  more  highly,  debugged  than  most  which  are 
distributed/  and  some  problems  have  been  seen  at  other  sites. 

These  codes  do  make  use  of  long  variables/  the  absence  of 
which  on  one's  installation  suggests  a  too-archnic  C-compiler. 

Optimization  of  the  codes  is  recommended.   (Refer  to  the 
0  ■  option. ) 

Sharable  text  is  emphatically  desirable.  (Refer  to  the  *-n* 
opt  ion . ) 

Split  I  and  0  space  increases  the  address  space  available  to 
the  Record -I/O  transfers.   (Refer  to  the  *-i •  option.) 
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At  this  writing  there  are  nine  source  files/  plus  two 
"further  header  files  bearing  defines/  structures*  and  external 
reference  types.  The  compiler  invocation  used  here/  at  the 
Center  for  Advanced  Commutation  is: 

cc  -0  -  n  - i  -s  pldef.h  plext.h  class. c  init.c  ioset.c  \ 
loqin.c  main.c  misc.c  scoi.imd.c  ucommd.c  dtp.c   -Ij 
The  reference  therein  to  */lib/libj.a*  brings  in   several   codes/ 
most  critically  the  triplet:  printf/  prints/  and  printc. 
libj  : 

getl.c  :  unnecessary  for  FTP  codes/  but  is  for  HELP 

ato.s  :  refer  to  included  'man*  files  for  ato/netl 

2pr  int .s 

3put c  r .s 

A  copy  of  the  system's  putchr.o  should  also  be   included   as 

Mputcr.o'   and   the  library  creation  should  insure  that  the 

numbered  files  are    archived  in  the  implied  order. 


Documentation  for  the  library  has  been  provided 
source  files  and  the  files  referred  to  above. 


a  long   with   t  he 


It  is  impossible  tc  run  these  codes  on  a  system  which  does 
not  support  the  Rand  EMPTY  call  and  the  ALARM  function.  (It 
would  improve  the  FTP  if  someone  would  extend  the  EMPTY  call  to 
cover  network  files.) 

3   Ownership  ?,    Mode 


The  object  of  the  compilation  above  is   the   User 
Server  FTP/  and  the  Server  initiator.   As  a  Server 
it  must  have  the  power  to  effect  a  login   for   the 
means  it  should  be  owned  by  root  and  have  its  mode 


FTP/   the 
and  Initiator/ 
users.    This 
changed: 


chmod  06555 


Server  Initiation 


Set  a  daemon  watching  your  chosen 
book)  which  spawns  a  srvrftp  process 
to  the  duplex  network  connection. 


FTP   socket   ( 


by 


i th  file  id's  0  and  1 


the 
set 


The  initiator  is  a  subset  of  the  FTP  code/  currently.  It 
must  be  executed  by  a  super-user/  and  its  FULL  pathname  MUST  be 
specified: 

/usr/bin/pftp   socket   3   X 
(Where  /usr/bin/pftp  is  the  full  pathname   of   the 
code   and   socket   3  is  the  socket  that  will  result 
execution.)  The  pathname  requirement  relates  to  the 
to  rXECL  itself  for  re-logons/  and  the  fact  that  it 
not  do  this  from  foot  (*/').   The  code  simply   rxECL's   "arqvr.Ol* 
—  the  name  under  which  it  was  initially  executed.   (Ie./  failure 
to  .live  the  full  name  may  not  prevent  an    initial  I  o  q  i  n  /  but   will 
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prevent   the 
later  on.) 


proper  LXbCL  when  the  user  wishes  to  change  account 


5   Anci  t lary  codes 

There  are  a  multitude  of  codes  used  by  or  via  the  FTP  codes. 
The  source  code  for  the  h  e  I  {_;  -function  is  provided  as  it  is  of 
local  origin.  (The  other  cooes /  such  as  sh  are  supplied  as  part 
of  the  bell  release.) 


The  helo  source  is  currently  located  under  helr..c  .  It 
requires  libi-a/  as  does  the  FTP  code.  And  it  is  advisable*  but 
not  necessary/  to  compile  it  as  'sharable*. 

It  must  be  accessible  by  all  user  id's*  as  must  the  text 
files  it  references.  Help,  is  invoked  with  an  arbitrary  number  of 
arguments:  the  first  must  be  the  pathname  to  the  text  file  from 
which  paragraphs  will  be  excerpted;  the  remainder  are  paragraph 
id's  which  are  to  be  found  and  written  onto  the  standard  output. 
The  id's  need  not  be  in  the  order  in  which  they  appear  in  the 
text  file.  In  that  file*  the  paragraph  identifiers  appear  on 
lines  bearing  a  \# '  in  the  first  byte.  The  identifier  begins  in 
the  second  byte  and  may  legitimately  contains  blanks.  Several 
different  id's  can  be  attached  to  one  paragraph/'  forming 
synonyms.  The  matched  paragraph  runs  from  the  first  NOW— id  line 
after  the  matched  id  up  to  the  first  subsequent  id  line.  are 
system  standards.) 
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1   History 


IV.  Principles  of  Operation 
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The  full  FTP  codes  have  been  running  since  mid-spring  of 
1977.  For  the  past  several  months/  experiences  with  running  it 
and/  more  recently/  oddities  encountered  during  documenting 
i  t  C32  3  have  resulted  in  a  considerable  volume  of  relatively  minor 
changes. 


C3?3  It  has  probably  been  true  that  code  modifications 
have  been  used  to  minimize  the  number  of  caveats  required  in 
the  documentation.  Thus/  where  the  documentation  could  be 
made  less  confusing  by  minor  code  changes/  they  were  made. 
§i£  SSEL^C  programmers. 
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Outline  of  Document 


One  stumblino  block  in  document i on  this  code  is  its  sheer 
volume.  There  is  no  way  that  a  useful  document  could  be  prepared 
which  attempted  to  address  each  routine.  Rather/  it  will  be 
asserted^  tenuously/  that  the  code  is  adequately  documented 
internally  for  a  knowled gable/  Unix  and  C-lanquage  programmer  to 
follow  it.  This  documentation  will  address/  on  the  other  hand/ 
how  the  various  roles  of  the  FTP  package  are  handled/  and  will 
mention  minutia  of  the  code  or  system  when  it  is  felt  their 
discussion  might  assist  the  reader's  understanding. 

2.1   Terms 


Certain  terms  have  particular  importance  in 
and  merit  clarification. 


this   document/ 


Replies 


Replies  are  either  spontaneous  (indicating/  say/  a 
system  going  down)  cr  are  responses  to  a  command.  Valid 
responses  begin  'on  a  new  line*  (ie/  follow  an  end  of  I  ine) 
and  begin  with  a  three  digit  (decimal)  code.  If  the  text  to 
be  supplied  is  a  single  line/  the  fourth  byte  is  a  blank  bod 
the  text  follows.  If  the  text  for  the  reply  requires  more 
than  one  line/  the  fourth  byte  is  a  dash  (*-')  and  the  final 
line  repeats  the  three-digit  code  and  has  a  blank  as  its 
fourth  byte  —  just  as  a  single  line  reply.  -io  intermediate 
lines  may  begin  with  ANY  three-digit  code.L333 
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C333  This   duplicates   the  ARPA  conventions/  due  to 
absence  of  PLATFORM  specification  of  multi-line  syntax. 


the 
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attempting  to  open   connections, 
issuing   that  100  command/  it  will 
200  to  b9°  range. 


If   it   gets   as   far   as 
Later  send  a  reply  in  the 


When  a  command  is  sent/  no  more  commands  will  be 
accepted  until  an  affirmative  or  reject ive  reply  is 
received.  Herein  lies  the  problem/  if  multiple  non- 
'informative'  replies  are  if  the  reply  is  slow  to  arrive. 

Double-Fork  i  ng 

When  a  process  is  forked-off  to  run  independently  from 
an  ongoing  process/  that  'child*  process  becomes  a  burden  to 
the  parent.  The  child/  in  terminating/  becomes  a 
'<defunct>*  process  -  -  a  state  which  consumes  system 
resources.  To  release  the  child  from  this  state/  either  the 
'parent'  process  must  die/  or  a  WAITC)  call  must  be 
performed  until  a  reply  identifying  that  particular  child's 
death  is  received.  All  this  is  a  nuisance/  for  most 
processes  here  are  spawned  off  with  no  interest  in  their 
final  states. 
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Printf/ Prints 


The  reader  of  these  codes  will  notice  some  unorthodox 
formatting  codes.  The  package/  contained  in  iibi.a  supports 
a  more-or-less  conventional  ijrintf  --  with  an  optional 
file-id  preceedinq  the  format  string.  [ 3 4  D  Additionally/  the 
B£iQ£s  call  can  be  found.  This  matches  grintf  except  that 
the  first  parameter  is  a  buffer  address   and   the   formatted 


C343  Problems  can  arise  in  split  I/D  space/  where  a 
format  string  'could1  have  an  address  less  than  1o  —  and 
thus  be  confused  with  a  file-id. 
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output  is  placed  therein*  rather  than  written.  Whichever 
code  is  used*  the  call  returns  the  number  of  bytes  created* 
or  a  -1  if  an  error  occured  on  o  write. 

Formatting  commands 'which  arc  rarely  seen  elsewhere  are 
*%r*  and  *%\fi'.  The  former  says  that  the  next  parameter  is 
the  address  of  a  new  format  vector;  ie*  the  first  vector 
element  is  the  address  of  a  new  format  string*  and  the 
subsequent  elements  are  the  values  to  be  used  with  the 
format.  (Rf:  corrmrep.  I  y  ( )  for  an  example.)  The  latter 
format-string  (*%\0')  is  used  to  place  a  zero-byte  in  the 
text  generated  by  the  L;£2Qts  ~~  thus  turning  the  generated- 
text  into  a  string  for  later  string -manipulation. 


3   Role'Determination 

PLATFORM  FTP  runs  ns  one*  sharable  code  performing  both  the 
User  and  Server  functions.  The  Server  function  is  that  of 
accepting  and  acting  upon  Protocol  commands.  It  is  a  Protocol 
Interpreter  L  P 1 3  and  Data  Transfer  Process  LDTPD  with  the 
responsibility  of  managing  Network  10  for  command/ rep  I y  10.  The 
User  function  combines  the  User  Interface  [UIJ  responsibilities 
--  the  managerial  tasks  of  controlling  and  "understanding*  two 
subservient  PI  —  with  the  Local  PI  and  DTP  tasks.  when  the  UI 
is  effecting  its  own  PI  functions*  the  communication  functions 
between  the  UI  and  PI  are  handled  by  internal  buffers*  rather 
than  burden  the  system  with  10  calls. LS51 

Whether  the  User  or  'Server  role  is  being  performed*  its 
commands  are  received  via  the  standard  in  rut  and  its  replies  and 
annotations  are  returned  via  the  standard  2liiQyl«  To  determine 
the  function  being  performed*  the  standard  inp_ut  is  examined 
using 'f stat () .  The  length  of  the  returned  array  indicates 
whether  the  commands  are  being  received  from  the  Network*  cr  from 
a  local  file.  (A  shorter  array  is  returned  for  a  Network  file. 
R"f:  initio  Liil£('-)  A  Network  file  for  the  standard  input 
indicates  that  the  Server  functions  are  to  be  performed. 
Otherwise*  invocation  parameters  indicate  whether  the  User  or  SI 
role  is  des  i  red . 


C  3  5  3  The  often  mentioned  effect  of  this  approach  is 
that  the  decision  to  run  the  UI  and  Local  PI  in  one  process 
actually  requires  additional  code*  as  the  UI  has  to  handle 
tile-controlled  Pi's  regardless. 
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The  Server  must  be  initialize d  to  reflect  that  the  default 
transfer  partner  is  the  Command  host*  and  that  the  table  of 
acceptable  commands  is  that  of  a  Server. 

The  User  process  must  force  the  effective  uid  and  gid  to 
reflect  the  user's  uid  and  g  i  d .  And  it  must  establish  the  proper 
table  of  commands. 

4   Command'Parsi ny 

Server  and  User  FTP  share  the  command  parsing  code. 
However*  the  particular  role  being  performed  disables  certain 
tests*  and  each  has  its  own  table  of  acceptable  commands . [363 

Commands  are  not  scanned  until  an  entire  "line*  has  been 
recei ved . C3 73  This  buffer  (cmdbuf)  is  512  bytes  long  and  limits 
the  acceptable  command  line  length. [383  The  I i ne-t e rm i na t o r [3 93 
is  replaced  with  a  liull  (zero -byte)  in  the  buffer.  By  the 
Protocol*  lines  may  only  contain  *Print3ble~ASCII,.[403 

In  User  mode*  the  line  may  bear  a  'flag*  command  and  NOT 
require  table-searching;  thus*  an  initial  byte  of  **'*  *?'*  or 
*!'  triggers  special  h a nd ling. £41 3 


[363  This  marriage  of  functions  may  merit  divorce*  as 
it  reflects  in  earlier  coincidence  of  interests  that*  many 
modifications  later*  is  no  longer  obvious. 

C373  Out  of  deference  to  the  Server's  re-login  needs* 
discussed  below*  commands  lines  are  acquired  by  single-byte 
reads . 

C333  An  unacceptable  line*  for  whatever  reason*  is 
flushed  with  an  'appropriate*  error  message. 

[393  CR/LF  (carriage-return*  linefeed)  for  Server 
commands;  and  NL  (Newline:  i e*  Linefeed)  for  User-Interface 
commands . 

C4?3  The  carriage-return  which  is  required  for  NVT- 
ASCII  line  termination  is  thus  forbidden  in  User-Interface 
mode. 


C41D  Refer    to    "flag    commands'  ■  in     the     User 
document  at  i  on . 
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The  command  verb  is  right-delimited  by  the  first  blank  (or 
the  terminating  Null).  The  global  arc;  points  to  the  first  non- 
blank  byte  following  the  command  delimiter/'  or  is  set  to  zero  if 
none  was  found.  (Thus/  the  commonly  seen  test  for  'am  ==  0* 
tests  whether  or  not  there  ARfc  any  argument  fields.)  Leadinq  and 
trailinq  blanks  are  'removed*  by  advancing  the  arn  pointer  and  by 
left-adjusting  the  terminating  Null. [A 23 


The   commands  are       searched   for 


MIT  t  uiiiiiiciiiu  5  a  i    c  ;>  c  o  i    v.  1 1  c  u  i  \J  \  ill  in?   u  cJ(.'|Ji   U|.'i     i  a  ic 

table. C A  33  The  'case*  (upper/lower)  of  commands  is  irrelevant  to 
the  matchs  and  UJ  commands  can  be  truncated  as  lon.i  as  they  match 
a  the  leading  characters  of  a  single  command. C4 4 3 

While  an  unrecognized  PI  command  is  handled  as  an  error/  an 
unmatched  Ul  verb  is  sent  to  the  appropriateC453  Pi  if  that  PI  is 
remote  --  ie/-  if  it  is  controlled  across  a  Network  connection. 


struct  fOMARR 


/*  format  of  the  command  table  */ 


char  *cmdname; 
int  (*cmdf unc)  ()  ; 
char  datareq; 
char  va  li  d  state; 


/*  ASCII  name  of  command  * / 

/*  command  procedure  to  call  */ 

/*  characteristics  of  data  */ 

/*  if  ( (va I. .>>stateindex) S1 ) 
**    then  ok  to  execute  * / 


>; 


C423  This  de-blanking  of  the  leading  and  trailing  edges 
of  the  argument  area  is  contrary  to  the  Protocols  but 
reduces  the  sioniticance  of  various  typographical  anom  a  I  i  e  s  /■ 
such  as  filenames  with  imbedded/  trailing  blanks. 


CA33  The 

I  commands  . 


Server  uses  commands;  the  User  Interface  uses 


C443  An  exception  is  the  LOGIN/LOGON  situation  Here/ 
there  rire  two  names  for  the  same  command  --  and  it  is 
permitted  to  use/  say/-  'log'  as  an  abbreviation  although  it 
matches  *two  commands1. 

C  4  5  3  Unrecognized  UI  commands  beginning  with  an  *  L  *  are 
presumably  special  site-implementations  for  the  Local  Pi; 
other  unmatched  ones  are  presumable  for  the  Foreign  site. 
(That  initial  *  L  '  is  strip ped-off  before  shipment.) 
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The  matched-command  hdS  four  attributes:  its  name/  the 
subroutine  which  is  called  if  the  command  is  acceptea/  the 
required  attributes  of  its  data  field/  and  the  required  'state* 
of  the  code  for  it  to  be  accepted.  The  data-field 
characteristics  are  checked  at  this  point  only  to  reduce  the 
repetitious  checks  later  on:  'no  argument  is  acceptable'/  'some 
argument  must  be  present'/  and  'the  argument  field  is  to  be 
ignored  at  this  time'  are  the  possible  requ i rement s . [463 
(Clearly/  the  latter  is  a  non-restrictive  one.)  Content  analysis 
of  the  field(s)  is  deferred  to  the  appropriate  subroutine  for 
that  command.  Although  acceptable  in  other  respects/  a  command 
may  arrive  while  the  til  *  s  'state'  ( s t ate±ndex )  does  NOT  permit 
the  command's  execut i on  .  C 473  L4o3 

Both  the  UI  and  the  PI  freely  alter  the  command  line  buffer/ 
replacing  field-terminating  characters  with  Null-bytes/  and 
otherwise  altering  the  line  to  reflect  the  parsing  operations. 
Furthermore/  the  UI  is  not  beyond  pointing  arg  outside  the  buffer 
while  it  is  faking  the  command-IO  to  its  internal/  Local  PI. 

5   Logins 

The  U I  and  Server  login  functions  are  entirely  seperate 
codes/  allbcit  their  functions  fit  together/  hand  in  glove. 

The  Server's  login  codes  execl  a  new  copy  of  the  FTP  code 
before  setting  vhe  u  i.  d  and  2  i.  d  to  reflect  the  login 
i nf ormat ion .[ 493   The   exeel   is   performed    immediately    after 


C  4  6  3  This  general  syntax  analysis  can  le^d  to  one 
particular  problem:  rejecting  the  parameters  of  a  transfer 
command  should/  perhaps/  force  a  reset  of  each  site's 
transfer  variables.  However/  an  error  c a u o h t  here  doesn't 
trigger  that  action/  and  the  external  test  for  transfer 
parameters  should  probably  be  dropped  in  favor  of  an 
internal  one. 

C473  The  states  for  a  Server  are:  EXPECTUSER, 
EXPECTPASS/  EXPECTCMD/  and  XFERRING.  The  User-Interface  is 
limited  to  states  of:  EXPECTCMD  or  XFERRING.  Eg:  The  User- 
Interface  rejects  DEFINE  commands  while  a  transfer  is 
ongoing;  and  the  Server  rejects  RENAME  while  it's  awaiting  a 
login/  or  transferring. 


[4i'3  The  UI  also  attempts  to  infer  the 
servers  it  is  dealing  with.   More  is  said  on 


state   of   the 
this  elsewhere. 


CA'O  Loiins  require  §etyid()  and  setgidO  calls/   which 
can   only   be   accomplished   by   a   super-userLSUJ.   A  newly 
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receiving  the  user  command.  The  yscrid  (from  that  command)  is 
passed  to  the  execl-ed  code  as  an  invocation  argument-  (Waiting 
until  the  L§£S  command  was  also  .  received  would  force  that 
password  to  also  be  passed  as  an  argument  --  where  it  might  be 
compromised  vi-i  the  ps  command.)  Th°  requirement  for  an  e^rl. 
means  that  any  buffered  input  would  be  j eopa r di zed .  Rather  than 
effect  complex  machinations  to  avoid  this  loss/  or  presume  that 
no  site  will  'burst*  the  I  o  g  -  i  n  infor -nation/  FTP  reads  only  one 
byte  at  a  time  on  the  command  connection  —  an  embarassinq/  but 
practical  action  on  this  very  low  bandwidth  connection. 

FT^  first  attempts  to  log  in  using  just  the  User  Id...  thus/ 
accounts  which  have  a  null  password  will  work  with  just  the  user 
command.  If  that  attempt  fails/  the  reply  code  and  text  indicate 
that  the  Li^s  command  is  required.  Upon  its  arrival/  another 
attempt  is  made.  A  defined  number  (currently  six)  of  consecutive 
failures  are  tolerated  before  the  Server  abandons  the  process  by 
EXITing. 

If  the  user/Qass  pair  are  properly  matched  in  the  site's 
password  file/  en  attempt  is  made  to  chdir  into  the  user's 
working  directory.  A  failure  here  is  not  fatal/  but  requires  a 
new  login  attempt.  (Some  password  file  entries  have  deliberately 
invalid  working  directory  entries  for  administrative  reasons.) 

If  the  site's  password  file  is  unreadable  for  the  user/  the 
dump -message  tile  (supposedly  explaining  the  reason  for 
restricted  access)  or/  in  its  absence/  a  brief  message  is  sent  to 
the  user  and  the  Server  EXITs. 

The  User  process  hasn't  a  direct  parallel  to  the  Server's 
log-in  sequence.  The  Ul  accepts  the  "current  working  directory' 
and  the  current  user  id*. [503 


executed  FTP  has  this  Si)  status/  but  it  is 
successful/  non-SU  loo  in  occurs...  hence/ 
attempt  the  FTP  code  must  be  re-EXECL-ed. " 


lost   when   a 
for  each  login 


C5  >3  The  LLOGIN (LLGGON)  command  parallels  the  LOGIN 
command  which  will  be  described  below.  However/  the  effect 
of  this  command  is  NOT  to  respecity  the  user  id'  and  working 
directory  directly/  but  to  create  a  three-party  situation 
wherein  the  "pseudo-local'  site  --  which  is  addressed  by  the 
same  commands  that  would  have  otherwise  been  handled  within 
the  UI  Protocol  Interpreter/  are  now  shipped  out  over  the 
network  --  even  if  the  destination  is  still  technically  the 
user ' s  site. 
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C  lasses 


Th2  protocol  requires  the  recognition  of  classes/  but  leaves 
their  details  unspecified.  The  implementation  chosen  supports 
the  basic  interactions  one  might  require  with  a  Unix  system/  but 
is  not  an  attempt  to  reach  for  any  broader  generality. 


The  re 
references 
and  user-declared  ones. 


are  both  pre-defined  classes  --  which  the  user 
by  name  (or  by  implication/  in  the  "default"  case)  -- 
No  distinction  is  made  between  pre- 
defined anci  user-defined  classes/  so  the  u>cr  must  exercise  the 
simple  precaution  of  not  accidentally  overwriting  or  modifying 
the  former. 

Pre-defined  classes  are  compiled  into  the  classes  array  of 
FTP.  These  are  stored  in  exactly  the  same  way  they  would  appear 
on-  a  PI  *DEFI  '  line. £513 

The  array  classex  is  the  contiguous  extension  of  classes/ 
and  its  size  represents  the  space  allocated  to  user-defines  and 
to  modifications  to  the  compiled- in  definitions.  This  array  end 
c_L§s_§e?s_  are  treated  as  one  array/  with  its  head  matching  the 
tatter's  and  its  tail  matching  the  former's. 

When  a  class- definition  is  processed  --  either  from  the 
command-  input  buffer  or  from  t  lie  c  la  sses /classex  buffer  --  it  is 
syntax  scanned  and  its  various  keyword-values  ^re  stored  in  a 
Structure-array/   keys.   In  this  array/  both  the  binary  value  (if 


L513  Rrfer  to  the  user-documentation  for  an  explanation 
and  to  the  character  array  classes  for  an  example  of  its 
initiali  zat  ion. 
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appropriate)  and  a  character  pointer  to   the   key  wo rd- va luc   are 

kept.    If  the  command  creates  a  new  classes  entry  --ie*  if  it  is 

a  definition  or  a   redefinition   —  *  the   strings   for   this  ore 
extracted  via  these  pointers. 


Generated  defines  will  be  imbedded  at  the  end  of  the  List 
unless  a  cross-check/  relating  the  keyword -values  to  one  another/ 
shows  an  error  or  unless  there  is  inadequate  room.  If  a 
redefinition  produces  an  error/  the  original  value  will  be  left 
unchanged. 

It  is  worthwhile  to  repeat  a  warning:  user -definitions  will 
be  imbedded  in  the  classes  array  only  if  they  are  syntactically 
acceptable.  Compiled-in  definitions  may  be  incorrect/  however/ 
and  the  result  can  be  two  error-messages  beinj  returned  for  the 
one  command  —  a  confusing  situation  for  the  UI  as  this  is 
strictly  forbidden. 

7  10'Setup 

The  rename/  delete/  send/  and  fetch  operations  all  require 
Unix  filesystem  interactions  which  are  effected  or  initialized  in 
the  10  Setup  codes.  For  the  most  part/  the  requirements  herein 
are  obvious  to  any  Unix  user.  (Some  actions/  such  as  executing  a 
file  copy  to  effect  a  renarng/  are  less  obvious/  but  are 
defensible  in  view  of  the  simplified  code.)  A  murky  area 
surrounds  the  shell,  invocations  and  the  generation  of  pathnames. 

<insert  IOSET  discussion  here.> 

8  Data'Trans  fer*  Process 

The  Data  Transfer  Process  CDTP3  is  forked- off  from  the  10- 
setting  codes  with  all  the  file  id's  set  and  with  the  paraneters 
of  the  transfer  fully  'accepted*.  It  terminates  only  upon;  (1) 
its  master-process'  death/C!>2]  (2)  'timing  out'  on  the  attempt  to 


C  5  ?3  The  process  double-fork  i  no  the  DTP  monitors  that 
grand  child* s  progress  b>  a  Pipe  --  referred  to  herein  as  the 
Status  Pipe.  If  the  DTP  finds  its  end  of  the  pipe  closed/ 
this  indicates  the  grandparent's  death. 
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establish  dot  a -connections/  (3)  an  unacceptable  incoming  Segment 
Header^  ( U )  filesystem  10  errors/  (5)  a  kill  from  the  master- 
process/C533  and  (6)  successfully  completing  the  transfer. 


8.1   OTP'Init iation 


The  DTP  is  

become   a  *<defunct>*  process, 
anything  relevant  — 


double-forked  --  so  that  upon  death  it   will   not 
process.   and  uses  this  opportunity  to  note 
such  as  Record  10 


8.?   Data-Connections 


Having  released  the  Server's  attention,  the  DTP  must  open 
the  number  of  connections  arbitrated  earlier  via  the  CONN 
exchange.  The  local  sockets  to  be  used  are  offsets  from  the 
local  command /rep ly  socket.  C5  A3  C  b  5  3  C  56  3  because  a  SOCK  command 
may  have  been  used  to  completely  alter  the  target  of  the 
connection   from   the   default   site/   the   foreign   end   of   the 


C533  The  ABOR  command/  a  lost  control  connection/  or  a 
received  ouiT  will  result  in  the  master-process  closing  the 
read  end  of  the  'status  pipe*/  thus  killing  the  process  next 
time  it  tries  to  write  on  it. 


C5A3  Refer 
documents. 


to  Unix  Network  files  as  described  in  other 


C553  For  reasons  which  many  rewrites  have  obliterated/ 
the  com  in  and  file  id'  is  DUPed  into  foreign. n_CornmF  id  and  thc- 
standard  input  and  output  are  closed.  Thus 
foreign. n_C cm m Fid  is  the  local,  file  id'  off  which  the  data 
sockets  are  suspended. 
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connection    is    done 
enumero t  ion .[ 573 


with 


an 


*  abso  t ute • 


site/socket 


In  the  data-connection  opens/  as  on  the  later  network 
READ/WR  J  TG  s  /  each  OPEN  is  surrounded  with  an  ALARM  set/reset. 
The  Unix  NCR  at  this  time  does  NOT  support  timeouts  on  either 
data-connection  OPfcNs  or  Network  READ/WRITEs.  (It  does  time-out 
on  1 CP  opens . ) 

The  successful  completion  of  connections  is  signalled  to  the 
Server  by  sending  a  single  * . ■  across  the  Status  Pipe.  Any 
failure  to  establish  connections  is  signalled  by  the  DTP  writing 
a  properly  formatted  reject ive-reply  onto  the  Status  Pipe/-  and 
closing  this  pipe. 

8.3   UI /PI "Dur i ng "T rans f er s 

The  beginning  of  a  transfer  is  heralded  with  the  *  1  0  0  ' 
reply.  The  site's  stateindex  is  moved  into  kr§*i£  Estate  E  5  83 
(and  the  UI's  presumption  of  this  P  I  *  s  state  is  moved  into  * - 
>D_L!E§ii§Eit  at  e  )  .   The  new  state  becomes  'TRANSFERRING*. 

Since  certain  commands T5 93  must  still  be  processed  by  the 
PI/  restrictions  are  required  to  prevent  the  replies  from  these 
being  confused  with  the  final -status  replies  from  the 
independently  running  DTP.  Thus/  only  certain  repliesC603  are 
legitimately  permitted  for. the  concurrent^  running  commands  -- 
and  these  reply  numbers  are  strictly  prohibited  for  the  DTP. 


L573  The  data-host  number  is  stored  in  foreign. n_datai d 
and  its  base  data-socket  is  in  foreign. n_dataskt. 

ZSb'l  The  reason  for  retaining  information  on  the  state 
of  the  code  prior  to  the  transfer  is  that  eventually  it  will 
be  necessary  to  permit  transfers  from  more  th.n  one  state. 
After  a  transfer/  that  state  would  be  returned  to.  One 
example  of  this  would  be  nail  deliveries/  where  the  transfer 
is  effected  without  I  o  q  u  i  ruj  in. 


C5°3  Abor/  nooQ/  Quit/  and 

C6'0  Legitimate   concurrent-command   replies 
211/  213/  214/  215/  216/  217/  222/  421/  422/  50U/ 


are:  200/ 
and  506. 
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8.4   Tr dns f er-buf fe rs 

The  reader  is  presumed  to  be  familiar  with  the  PLATFORM 
Protocol/  rind  hence  with  the  details  of  PLATFORM  Segments  and 
their  header-information  of  three  bytes.  The  reader  should  a!,  so 
realize  that  the  Unix  NCP  offers  no  guaranteed  correlation 
between  the  number  of  bytes  per  WRITE  at  one  end  of  the  data- 
connection  and  the  number  of  bytes  per  READ  of  that  data  fit  the 
other  end.  Specifically/  the  data  can  be  viewed  as  a  stream  with 
a  guaranteed  order  and  length/  but  with  NO  correlation  between 
thegyantit^  of  data  transferred  per  10  call  at  each  end. 

With  the  data-connections  completed/  the  task  of  the  DTP  is 
to  map  incoming  data  f  r  o  t:  PLATFORrt  Segments  into  local  records 
and  outgoing  data  from  local  format  to  PLATFORM  Segments. 
Incoming  data  is  accumulated  into  a  full  segment  regardless  of 
the  fact  that  most  data  could  probably  be  handled  on  receipt  -  - 
ie,  in  the  sub-Seoment  portions  returned  by  the  READs.C613 
Symmetrically/  outgoing  data  is  assembled  into  a  Segment  before 
being  written.  A  minor  ploy  on  writes  is  that  the  'define' 
£i££&§£L:5Z.  is  used  to  limit  outgoing  segment  sizes  to  reduce  the 
buffer  space  allocated.  L62  2 

The  concept  of  parallel  data-connections  is  supported/  but 
without  a  mechanism  to  effect  the  desired  transfer-rate 
improve ment.C63J  C64D  The  parallel  connections  arQ    handled  Ly  the 


C613  The  approach  used  requires  an  £Kb  buffer/  which 
could  be  reouced  to  about  1  ^  b  if  the  full  segment  was  NOT 
accumulated  prior  to  processing.  The  cost  would  be  some 
decrease  in  the  straightforwardness  of  the  codes. 

C6?3  The  current  value  of  the  define  is  2  DA  8.  The 
receiving  side  might  be  modified  to  only  expand  to  the  size 
required  for  the  incoming  Segment  --  however/  as  of  this 
time  the  (quite  surmountable)  problem  is  that  a  later  S  Fi  R  K 
call  is  *in  the  way*  of  any  required  buffer  expansion. 
"Tuning*  the  system  --  such  as  this  would  be  --  seems  futile 
in  the  face  of  pending  Protocol  rewrites. 

C  6  3  3  The  aspirations  and  realities  of  this  dilemma  are 
embedded  in  the  Unix  NCP  and  have  been  addressed  elsewhere 
by  K.  Kelley.  The  methods  for  circumventing  the  NCP 
problem/  in  the  short  run/  involve  using  seperate  processes 
to  drive  each  parallel  connection/  receiving  their  data  via 
pipes  from  the  main  DTP  process.  The  mechanism  to  do  this 
is  nearly  straightforward  --  the  challenge  being  to  impart 
grace  to  the  endless  minor  steps  required  to  cope  with 
c rror-nut i f icat ion.    However/   the   impact   of   two    pipes 
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round-robin  transfer  of  specified  amounts  of  data  over  the 
arbitrated  number  of  connections.  The  NCP  problems  with  this 
have  been  discussed  in  a  paper  by  K.'  Kelley*  and  will  not  be 
repeotecJ  here.  FTP  is  written  to  t;ike  immediate  advantf«ne  of 
non -blocking  10  if  that  becomes  available. 


passing  data  and  three  network-connections  beinq  saturated 
—  for  each  FTP  user  --  would  be  an  impressive  attack  upon 
the  available  system  buffers. 


C643  Rf:  netioO. 
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Appendix  A:   Sample  Usage 


urf.osc  of  this  file  is  to  provide  several  examples  of  the  use  of 
T  P  code. 
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;:  =  SNDMSG  destination 

;:  =  SNOMSCi  copies-list 

;:  =  SNDMSG  title 

Run  FTP/  echoini  commands/  into  SNDMSG 


A  Command-file  Driven  Simple  Transfer 
ocat  ion  line: 

sh  comml  |  sndmsg  >/dev/null  R 

mand  file:  comml 

echo  j  c 

echo 

echo  FTP  Results  Mailed 

ftp  echo  [ 

*  suicide  --  die  if  logon  aborts 
toggle  suicide 

*  *!'  in  passwd  field  is  escape  to  masked-response  after  next  promp 
lor,  nts|11ssuprjc.s! 

<--Password--> 
type  i 

*  suicide  --  <reset>  permit  500  on  LDELETE 
toggle  suicide 

Idelete  file  tmpunix 

*  blocked  --  refuse  commands  until  transfer  terminates 
toggle  blocked 

*  suicide  --  die  if  transfer  aborts 
toggle  suicide 

fetch  file  file  tmpunix  /unix 

*  check  on  test  results 

•cmp  tmpunix  /unix  ; 

quit  i 

|Ly  file:  <extr acted  from  mailbox>  J 

)ate:  16  Oct  1977  at  0207-CDT 

From  :.  s  u  p  r  j  c  £  ILL-NTS 

To :  j  c 

Jubject:  FTP  Results  Mailed 

j2  00  'echo'  OK 

:  *      suicide  —  die  if  logon  aborts 

I  toggl e  sui  ci  de 

i200  'toggle'  OK  \ 

*      "!'  in  passwd  field  is  escape  to  masked-response  after  next  prompt 
:  lo»  nts|11ssuprjcs! 
"asswor'l: 

/111  Attempting  Conn*  to  'nts|ir 
i111  Open  (Reply  P.  Id.  90) 

220  'ill-nts'  PLATFORM  sFTP  vl.OO  (P. Id.  88):  Sat  Oct  15  12:07:46  1977 

331  PASS*ord  Cmd,  S.V.P. 

230  Logon  OK 

t  y  p  e  i 
i200  'type*  OK 

200  *type*  OK 
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:  *      suicide  —  <reset>  permit  500  on  LDELCTC 
;  1 01 g I  e  suicide 
u20C  'toggle'  OK 
:  (.delete  file  tmpunix 

u555  'Idelete':  Inaccessible--  'tmpunix*   No  such  file  or  directory 
:  *      blocked  —  refuse  commands  until  transfer  terminates 
!:  toggle  blocked 
u200  'tojgle'  OK 

:  *      suicide  --  die  if  transfer  aborts 
I  toggle  suicide 
u200  'toggle'  OK 

:  fetch  file  file  tmpunix  /unix 
f200  'conn*  OK 
u200  'conn'  OK 

u100  'fetch':  Attempting  Data  Connection  (P. Id.  81) 
f200  'pasv*  OK 

f100  'retr':  Awaiting  Data  Connection  (P. Id.  89) 
f113-*retr*  Done.  Segs:27  netfc:54099  Ul8:54u18 
f 1 1 3  Seconds;  Real=38  User=8  Sys  =  4    Baud=11389 
f226  'retr'  Done ! 

u113-"f etch1  Done.  Segs:27  net8:54099  lcl8:54018 
u113  Seconds:  Real=AfJ  User  =  0  Sys=4    3aud=1GG19 
u226  'fetch*  Done! 
:  *      check  on  test  results 
:  !cmp  tmpunix  /unix 
1 

:  qu  it 

f 2 21  'auit'  ree'vd:  Autvneder.se hen.! 


<<  subsequent  run    using  ARPA  FTP  achieved  12026  baud  >> 


>e  that  lines  begin  with 


•  -  •   •  1 .  • 


u * e    or  ,fr.   The  latter  two  distinguish 


(ween  User-ftp  and  Foreign-ftp  responses.   The  ':'  lines  are  prompted 
•ponses  from  the  user. 

>e  the  specific  ICP  socket  declaration  (*|11'>  which  is  necessitated  because 
l  uses  socket  11  for  PLATFORM  FTP. 


l|e  thf.»t  responses  beginning  with  **'  are  comments/  and  that  those  beginning 
ih  '!*  are  fcSCAPEs  from  FTP. 
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i   A    Command-file    Driven    3    Party    Transfer 
■vocat  i  on    I  i  nc  : 

ftp   echo    blocked    <comm2    >reply2    6 

irmand    file:    coram  2 

llo'jon    i  I  l-nt  s  |  1 1  />  j  c,  ! 

<--^os  swo  rd--> 

logon    i  I  l-nts | 1 1  * sui  r j c / ! 

<  —  pa  sswo rd--> 

type    i 

Is t  at  us 

status 

ust  £t  us 

fetch    file    tile    tmpunix    /unix 

qu  i  t 

ply    file:    rep  ly 2 

u200    'echo'    OK 

u200     'blocked'    OK 

:    lloaon    i  I  l-nts  1 1 1 /■  j  c,  ! 

Password: 

u111     Attempting    Conn*    to    *  i  tt-nts  f  1.1  ' 
iu111     Open     (Reply    P. Id.    88) 
•1220    •ill-nts'    PLATFORM    sFTP    vl.00    (P. Id.    10):     Sat    Oct    13    1?:55:A4 

1331     PASSword    Od/     S.V.P. 
!  1230    Logon    OK 

:    lo;,on     i  I  l-nt  s  |  1 1  /supr  j  C/  ! 

Password : 

u111     Attempting    Conn*    to    * i L l-nts j 11  * 

u111    Open    (Reply    P.  Id.    95) 
!f220    "i  I  l-nts.'    PLATFORM    sFTP    vl.00    (P. Id.    17):    Sat    Oct    15    13:56:03 

f 331  PASSword  Cmd,  S.V.P. 

f230  Logon  OK 
;:  type  i 
11200  'type'  OK 
If200  *ty{;e'  OK 
, :  I s  t  at  us 

1111-  Stat  (si  te  :i ll-nts) 

I  site: 

I   dita  socket:   2058(04012) 

I   byte:  8  *   conn:  1 r       type:  i  #   voice:  Active 

I   Base  Con'  Host:  76(0114),  sock : 2066 (04022 ) 

1111  Stat 

1215    Lorded    In    (Next    Cmd/    Sire?) 

:    status 

If  111-    Stat     (site:il  l-nts) 
\i    site: 

f      data    socket:      2074(04032) 


1977 


1977 
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i/   voice:  Active 
sock:20o2( 3404  2) 


f   byte:  8*   conn:  1/   type: 

f   Base  Con'  Host:  76(0114)/ 

f111  Stat 

f 2 1 5  Loy.jecl  In  (,'Jext  CmcU  Sire?) 

:  ust  at  us 

u111-  Stat  (si te  :  i I l-nts) 

u  foreign  site:   ill-nts|11      Presumed  State 

u   Bdse  Con*  Host:  76(0114),  sock : 2072 (C403G ) 

u  pseudo-Local  site:   ill-nts|11      Presumed 

u   Base  Con'  Host:  76(0114)/-  sock  :  2f.;56  (  0401  0) 

u1 1 1  st^t 

v2 15  Loqjed  In  (Next  Crnd/  Sire?) 
:  fetch  fite  file  tmpunix  /unix 


:  Logged  In 
State:  Logqed  In 


conn  " 
conn  ' 
sock  * 
a  p  p  e  ' 
pasv' 
ret  r  ' 
ret  r  * 


OK 

OK 
OK 


(P.  Id.     67) 


Attempting    Data    Connection 
OK 

Awaiting    Data    Connection     (P. Id.    78) 
Done.    Sec;s:27    net8:54099    Lcl8:54018 
User=8    Sys=4 


Baud=9016 


f200 

1200 
1   1200 

1100 

f200 

f100 

f  1 13- 

f113    Seconds:     Re^l=48 

f226     'retr'     Done.' 

U13-*appe'     Done.    Segs:27    net&:54099 

1113    Seconds:    Real=52    User=0    Sys=4 

1226    *  a  p  p  e  '    Done! 

:    quit 

f 2 2 1     "quit"    rec'vd:    Auf w iede rsehen i 
11221     "quit*    rec'vd:    Aufwiedersehen! 

:e    the    addition    of     '  I •     Lines.       These    originated    at    the    Local-server-ftp 
le    3rd    party)    site. 

Jjje    th-it    password-display    is    suppressed    by    using    the     *!'    flag    in    the    password 
?ld/    3nd    then    placing    the    password    on    the    next    line. 


Icl8:54018 
Baud=8322 


fee    that    pseudo-local     HP    is     run    in    PASV    voice/    while    in 
[j    'foreign*    site    which    is    PASV. 


2-party     FTP     it     is 
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Record  10  --  Doth  True  and  Pseudo- 

perform  Record-Structured  10  there  are  several  rules.   First/  you  must 
re  a  value  supplied  with  the  RfcCIO  keyword  in  the  class  definition.   This 
ue  is  the  number  of  bytes  to  allocate  for  the  buffers/  and  is  therefore 
>   maximum  record-size  (in  tt-bit  bytes)  permitted  without  'folding' 
:ords.   ('Folding*  can  only  be  performed  at  the  appending  process/  as  an 
jidequitely  large  tape-read  request  results  in  an  error  return  on  Unix.) 
|»  only  viable  TYPb  for  Record  10  is  'type  i';   lacking  this/  the 
iwill  be  of  default  (*a')  type  and  you  will  frequently  find  your 
irieve -process  getting  errors  due  to  its  implicit  512 -byte  reads. 
jally/  the  device  should  be  a  'character  special  file'  if  true  Record  10 
i desired:  lacking  this/  the  retrieve  process  will  do  a  type  'i'  transfer 
ithe  append  process  will  do  pseudo-record  writes  in  which  the  three-byte 
uder  is  included  with  the  data. 


N  e  x  t 


rocat  ion  line: 


ftp  echo  |tee  reply3 
uroands  entered  from  keyboard: 


logon 
<--pas 
type  i 
conn  2 
de  f  i  ne 
Ideti  n 
send  i 
st  atus 
1st atu 
<CNTL- 


ill-nts|11/jc/! 
swo  rd--> 


tape/funct~rw/path=/dev/rmt^S/recio=B000 
e  tape/fur. ct^rw/path^/dev/rmt^s/recio-SOOG 
dent  ident  tape/0  tape/1 


s 
D> 


e  ly    text/    from:     reply? 


|u2 
: 

u1 
u1 
u1 
12 
f3 
Pa 
12 

m 

u2 
f2 

• 

u2 
f2 

f2 


Of)    *<arg>'    Assigned 
logon    i  I  l-nt s | 1 1 / j  C/ ! 


11 
11 
11 

20 
31 


Attempting  Conn'  to  *ill-nts|11' 

Using  Socket  11 

Conn*  Open  (Replies  via 


OK 


PLATFORM 
PASS  word 

s  s  w  o  r  d  : 

30  Logon 

tyt  e  i 

00  'type* 

00  'type' 

conn  2 

00  *  conn  " 


sFTP 
Cmd/ 


(P.  Id 

P. 


P. Id. 
15)cj 


98) 

i  ll-nts: 


r*on  Jun  27  03:56:03  1977 


Assigned 

Assigned 


00 


conn 


Assigned 
Assi  nned 


define  tare/tunct  =  rw/p,:.th  =  /dev/rrt*s/recio=8000 

AG  'deti1  OK:  'tape  Reel  0= 6000/ Funct  =  rw, Pa th  =  /dev/ rmt %s • 
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:  Idefine  tape/f  uric  t  =  rw/pa  t  h=/dev/  rmt%s/reci  o  =  8U00 
u240  *ldefine'  OK:  'tape  R  ec  10  =  8000/-  Fun  ct  =  rw  /Pa  t  h  =  /dev  /  rmt%s  * 
:  send  ident  ident  tape/0  tape/1 
u111  Usiri^  Record-Formatted  10 

u1C0  "send':  Attempting  Data  Connection  (P. Id.  11) 
|111  Using  Record-Formatted  10 

f100  *outp':  Awaiting  Data  Connection  (P. Id.  58) 
:  status 

f111-  Stat  (si  to  :i  Ll-nts) 
f  site: 

f   d:;ta  socket:   2290(04362) 
f   byte:   8    conn:   2 
f   type:   i    voice:  Passive 
f   crr.d   host:  76(0114),  so  ck  :2298  (  04372  ) 
f   data  host:  /6(0114),  so ck  :2300 (04374  ) 
f111  Stat 

f 2 1 7  Transferring:  8  Seg's  A  s  s  m  *  d 
:  1st  at  us 

u111-  Stat  (si te :i I l-nts) 
u  site: 

u   data  socket:   230GC04374) 
u   by te :   6    conn :   2 
u   type:   i    voice:Active 
u  foreign  site:   ill  — n t s 1 1 1 
u   cmd   host:  76(0114)/  so ck  :  2288 ( 04360) 
u   data  host:  76(0114),  so ck  :2290(04 362 ) 
u   Presumed  State:  Transferring 
u111  Stot 

u  2 1  7  Transferrinc:  24  Sea's  Assir. '  d 

1  u1  13-* send*  Done.  Segs:34  net8:4S918  Lc 18:4881 6 
u113  Seconds:  Real-34  User=4  Sys=3    Baud  =  11!>10 
u226  'send  *  Done ! 

f'f1 13-*outp'  Done.  Ser;s>34  net8:48918 
f113  Seconds :.  Real=30  User=0  Sys=3 
f2  26  *outp'  Done! 
f221  'quit*  rec'vd:  Auf wiede rsehen ! 


I c  IS: 48816 

Baud=13044 


e  that  the  CONN  value  was  explicitly  given.   This  has  since  been  dropped  as 
SER-command/  and  is  arbitrated  automatically  now. 

e  the  STATUS/LSTATUS  commands.   If  this  were  a  3rd  p<*rty  connection/  the 
&TUS  would  hove  been  routed  to  the  pseudo-local  ftp;  however/  here/-  the 
hange:  to  get  the  User-ftp  to  note  its  status  the  command  is  U STATUS. 

!e  format  of  the  Status  replies  has  been  changed  since  this  run.) 
e  the  *%s*  in  the  PATH  specification.   In  this  case/  the  path  was  supplied 
ilit  up  to  the  specific  drive  number.   Refer  to  the  Sl?*D  command  to  see 
lit  a  copy  from  drive  0  to  drive  1  occurred. 
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An  Indirect  Write 

?  W I N  D  R  keyword  notes  that  o  WRITF  to  this  class  involves  creatinn  an 
direct  copy  of  the  transferred  data.   Only  after  a  successful  transfer 
this  indirect  copy  appended  or  overlaid  upon  the  specified  file.   The 

■  a  s  e  followimj  the  keyword  indicates  the  PATHNAME  of  the  indirect  file 

:  must  terminate  in  a  directory.   The  final  level  of  the  pathname  is 
jiugly  string  that  is  unreasonably  unique  and  consists  of  the  the  hexi- 
cimat  process-id'  and  datt  (to  the  second!). 

Ithe  destination  is  not  a  SHELL/  this  file  truly  is  temporary  --  being 
i. inked  such  that  the  transfer-process's  death  will  annihilate  the  file, 
it  ever/  if  the  destination  is  a  SHELL/  the  file  must  be  eliminated  by 
I  shell  --  or  if  an  unsuccessful  transfer  occurs/  by  an  operator? 


i fo cat  ion  line: 

ftp  echo  I  tee  replyA 
(  ni na l-ent e red  commands: 


lo  nts|11/jc/! 
<— Passwo  rd--> 
Idesc  r 

Irdetine  da/windr=, 
•  r  in  a  b  c 


ce 


fetch  ident 

•Is  -I  abc 

type  i 

fetch  ident 

abort 

!ls  -I  abc 

qu  i  t 


listing:  replyA 


ident  da/abc  ls//mnt 


file  da/abc  /unix 


u200  'echo'  OK 
I:  lo  nts|  11/jc/! 
Password: 

u111  Attempting  Conn'  to  *nts|11' 
Open  (Reply  P.  Id.  20) 

"ill-nts*  PLATFORM  sFTP  vl.OO  (P. Id.  98) 
PASSword  Cmd/  S.V.P. 
Louon  OK 
:  Idesc  r 

ul 12—  Clcss  Definitions: 
ii  Default  F  u  n  c  t  =  r  a  d  n  /  P  a  t  h  =  *<  s 
null  funct=w/poth=/dev/null 
Ip  Funct  =w/She  1 1  =  Ipr  -r  '/.s  /Wl  ndr  =  /us  r  /t  mp 
tp  RecI0-M92/Funct=rw/Path=/dev/rmt%s 
da  Funct=radn/Path=%s 


u111 
f220 
f  331 
f230 


Sun  Oct  16  13:00:29  197? 
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u    Is    Funct  =  r/ShcU  =  ls    2s 

u112      <301    bytes    yet    available> 

u21 2    'desc  ' 

:    t  r  '  e  f  i  n  e    ds/windr  =  . 

u240    'Iroefine'    OK:     *da    Funct=radn /W Indr=. #Pat h=%s ' 

:     ! rm    abc 

i 

:  fetch  ident  ident  da  /  abc  I  s  /  /  m  n  t 

f200  •conn*  OK 

u200  'conn'  CK 

u100  'fetch':  Attempting  Data  Connection  (P. Id.  34) 

f200  'pasv'  OK 

f100  'inpu':  Await  in g  Data  Connection  (P. Id.  18) 

:  f113-*inpu'  Done.  Segs:1  nct8:513  lcl8:438 

f  1 1 3  Seconds:  Real=Q  User='_i  Sys=G    Baud=4104 

f226  *  inpu  '  Done  ! 

u113-*fetch'  Done.  Segs:1  net8:513  lcL8:438 

u113  Seconds:  Real=4  User=0  Sys=0    Baud=1026 

u226  'fetch*  Donel 

•Is  -I  abc 

Irw-r 1  root      438  Oct  16  13:01  abc 

i 

:  type  i 

u200  'type1  OK 

f200  'type*  OK 

:  fetch  ident  file  da /abc  /unix 

f200  'conn'  OK 

u200  'conn'  OK 

u100     'fetch1:    Attemptinq    Data    Connection    (P. Id.    93) 

'f200    'pasv'    OK 

f100  'retr':  Awaiting  Data  Connection  (P. Id.  87) 

:  abort 

u222  *abor'  rec'vd:  Transfer  Killed 

f222  'abor'  rec'vd:  Transfer  Killed 

:  !  I  s  -  I  a  b  c 

-ru-TT 1  root       438  Oct  16  13:01-  abc 

i 

:  qu  i  t 

f221  'quit'  rec'vd:  flui wi ede rsehen ! 

e  the  ESCAPE  lines  --  which  begin  with  *!'. 

e  the  arbitrarily  abbreviated  command  names. 

e  that  the  file  lenath  was  NOT  increased  despite  the  12288  bytes 
tten  into  the  temporary  tile.   This  was  because  the  ^BORT  killed  the 

rnsfer  before  successful  completion...  ergo/  before  the  temporary  fill 

bid  be  copied  into  the  destination  file. 


i    the  S»ltLL  input  —  via  the  LS  code. 
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ISHCLL  Destinations  --  Direct  and  Indirect 

i  following  will  illustrate  the  use  of  SHLLL  destinations  by  qivinq 

(example  of  diverting  output  to  the  line  printer  using  both  direct  and 

firect  methods. 

li  i nvocat  i on  line: 

(ftp  <  commS  >  reply5;  echo  d  o  n  e )  fc 

i  command  file:   commS 

toggle  echo 

toggle  blocked 

toggle  suicide 

logon  ill-nts|11/jc/'! 

<  —  password - - > 

describe  lp 

send  file  ident  ../src/init.c  lp 

rdefine  lp / she  1 1  =  lpr/ w i ndr  = 

send  file  ident  ../src/init.c  lp 

qui  t 

trace. list  in a:  reply 5 

u2(10  'toggle'  OK  i 

togg  le  blocked 
(200  *  toggle*  OK  ; 

toiqle  suicide 
(200  'toggle'  OK 

logon  ill-nts|11/jc/!  .  I 

idssword:  '■ 

111  Attempting  Conn'  to 

111  Open  (Reply  P. Id.  70) 

220  'ill-nts'.  PLATFORM  sFTP 

331  PASSword  Cmd,  S.V.P. 

230  Logon  OK 

descr  i  be  lp 

112-  Extended  DbSC 

Writable( Over-writing^  Using  Indirect  Copy) 

—  Into  Shell:  *lpr  -r  %s* 

1112   Desc  end 

212  'desc':  lp  Funct  =w,Sh  e  I  1  =  I  pr  -r  %S/-WI  ndr  =  /us  r /t  mp 
send  file  ident  ../src/init.c  lp 
'conn'  OK 
'conn'  OK 

'send':  Attempting  Data  Connection  (P. Id.  60) 
'pasv*  OK 

Creotinn:  /usr/tmp/~0  012.0ea7ad43 
'outp':  Awaiting  Data  Connection  (P. Id.  10) 
ii13-'send'  Done.  5egs:5  netl:9069  lcl8:8789 
i 13  Seconds:  Real=5  User=1  Sys=0    3aud=14510 


ill-nts|11'  ; 

vl.OO    (P. Id.    1S):    Sun    Oct    16    13:11:05    1977 


{00 

>00 

't00 

>00 

':I11 
i!00 
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UL8:8789 
Fiaud  =  9U69 


u2  26  'send  '  Done  ! 

f113-*outp*  Done.  Sens:5  net8:9069 
f 1 1 3  Seconds:  Real=4  User=1  Sys=1 
1226     'outp*  Done! 
:  rdefine  I p /  s h e  1 1  =  I y, r  * w i n d r - 
f24  0  *rdcf'  OK:  'lo  runct  =  w, She  1 1  =  Ipr  ' 
ident  ../src/init.c  Ip 
OK 
OK 

Attemptinq  Data  Connection  (P. Id 
OK 

Awaiting  Data  Connection  (P. Id. 
Done.  Segs:5  netS:9069  UL8:8789 

Sys=0 


send  file 

conn' 
conn* 
send  ' 
pasv  * 
outp  ' 
send  * 


f200 

u200 

u100 

f2C0 

f100 

u113- 

u113  Seconds:  Real=7  User=1 

u2  26  'send*  Done! 

f113-*outp'  Done.  Segs:5  net8:9069 

f 1 1 3  Seconds:  Real=9  User=1  Sys  =  1 

f226  'outp'  Done! 

:  qu  it 

f 2 2 1  "quit1  rec'vd:  Auf w iede rs ehen ! 


.  20) 
78) 
Baud=1 0364 


lcl8:87S9 

Baud=8061 


(e  the  different  Baud  rates 
faster/  and  would  be  more 


The  use  of  indirection  rather  than  piping 
so  on  a  burdened  system. 


Ip*  however/-  that  all's  not  copacetic:  Lurking  in  the  background 
inwardly  named  file  (see  below)  which/  in  the  case  of  the  indirect 
ca  shell*  must  be  removed  by  the  shell  program. 

-rw 1  jc        9522  Jun  28  02:09  "/ran  t  /  j  c  /"0008  .0e1  60c  f  0 

Te  previous  line  was  from  an  earlier  run...  The  current  run  used 
II  option  of  Ipr  to  remove  the  supplied  file.) 


i  s  an 
transfer 


the 
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Further  Shell  Games:   Pre-  and  Post-Processing 
?  following  uses  a  primitive  encryption  .algorithm  at  each  end  of  the 

jnsfer...  but  illustrates  a  possible  method. 

i 

*  invocation  line: 

ftp  blocked  |tee  rep  I  yd 
I  entered  commands: 

u200  "blocked'  OK 

:  u200  'toggle'  OK 

:  Ion  nts|11/jc/! 

Password : 

u  1 1 1  Attempting  Conn*  t 

u1 1 1  Open  (Reply  P.  Id. 

1220     'ill-nts'  PLATFORM 

f331  PASSword  Cmd,  S.V. 

f230  Logon  OK 

:  Idefine  dkryptoz-funct 

u2A0  'Idefine'  OK:  'dkr 

:    define    kryptO/funct=r 

f240    *def  i  '    OK:     'krytto 

:  descr  krytto 

f112-  Extended  DESC 

f  Readable ir    Ident  Req' 
if  —  From  Shell:   *cryp 
If  1 1  2   Desc  end 
If212  'desc':  krypto  Fun 
::  Ldescribe  d  k  r  y  p  t  o 

u112-  Extended  DESC 

u  Wr it ab le (Pve r-wr i t ing 

u  —  Into  Shell:  'crypt 

u112   Desc  end 

'desc  * :  dkr ypt o  Fu 
e  i 

'type1  OK 
*type'  OK 


u212 

:  tyi 

u200 

1200 

:  fet 

f200 

u200 

U111 

u100 

f200 

1100 

o  *nts| 11 ' 
89) 

sFTP  vl.OO  (P-Id.  11):  Sun  Oct  16  13:28:48  1977 
P. 

-*r wi ndr= . r she  I  I =crypt  "dy zgoth i c a"  <%s  >%s 
ypto  Func t  =  wrW Indr= . *  She  I l  =  c rypt  "dyzgothica"  <%s  >%s 
•shell=crypt  "dyzgothica"  <%s 
Func t=r/Sh e I l=c rypt  "dyzoothica"  <%s* 


d> 

t  "dyzgothi  ca"  <as ' 

ct=r# She LL= crypt  "dyzgothica"  <%s 


*■    Using  Indirect  Copy-r  Ident  Req'd)  I 

"dyzgothica"  <%s  >%s'  ; 

net  =w/ Wlno'r  =  . /•Shel  I  =crypt  "dyzgothica"  <'/.s    >%s 


ident  ident  dk rypt 0/ pass cpy  krypto / /et c /pass wd 


conn'  OK 
'conn*  OK 

Creatine:  . /"004  3. 
'fetch1:  Attemptin 

*  p a s  v '  OK 

*  i  npu  *  :  Awaiting  D 
f113-*inpu'  Done.  Segs: 
f113  Seconds:  Real=13  U 
f  2  26  'inpu'  Done! 

u  1 1  3  -  *  f  e  t  c  h  *  Done.  Segs 
;u113  Seconds:  Re  a  1  =  16  U 
u226  'fetch*  Done! 


0ea7b16c 

g    Data    Connection    (P. Id.    74) 

ata    Connection     (P. Id.    43) 
t>    net8:9916    lcl8:9901 
s<r  =  1    Sys=0         Baud=6102 

:'j    net8:9916    lcl8:9901 
ser=0    Sys=Q         Baud =49 58 
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:    !c»np    passe py    /etc/passwd 

EOF    on    passcpy 

i 

:    *    virtue    reworded! 

:    Q 

f 221     *quit*    ree'vd:    Auf wiedersehen ! 
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fcwould  not  be  a  challenge  to  imbed  some  manner  of  'hooks'  within 
I  FTP  code  so  that  encryption  could  be  internally  accomplished. 
[ire  must  be  some  discussion  of  the  possibility  of  permutations 
ter  than  one-to-one  mappings  before  this  step  is  taken/  however. 


PLATFORM 
A  p  p .  B  : 


FTP 

UI  Help 


78 


Text 


Appendix  D:   User  *?•  Text 


**************************************************************** 
***    This  file  is  the  hELP-text  lor  the  user-interlace  code  of 
*  *  *   the  PLATFORM  FTP.   It  is  accessed  in  that  code  via  the 
***   *?f-headed  line.   The  Appendices  of  the  PLATFORM  documenta- 
***   tion  shall  also  include  a  copy  of  this. 

//notes 
//  b  r  i  e  f 
tf  int  ro 

//? 

"  ?-■  provides  assistance  in  2    primary 

?  COMMAND    --  provides  the  command 

?  ♦COMMAND   —  provides  an  explanat 
Also: 

?  commands   —  lists  commands  (and 
ft  commands 


The  details  on 
Commands  to 

abort 

fetch 

Idescr  i  be 

logi  n 

Ls tatus 

send 

"mail"  may 
For  synt  ax/- 


which  there  are 
s  e  r  FTP: 

byte 

f mpas sword 

Lfm password 

logon 

mpass 

status 


•> » 


mo 


ways  : 
synt  ax . 

ion  of  the  command . 

'tokens')  having  HELP  info 
dules  are: 


del et  e 
d     Ide  fine 
rd    I  logi  n 

Irdef i  ne 
rde  fine 
type 

only  be  executed  ny  super -users... 
type:  ?  name        For  Description  type: 


def i  ne 
fpasswor 
I f  pas  s wo 
Impass 
qu  it 
toggle 


des c  ri  be 
Ide I et  e 
1 1 og  on 
I  r  e  n  a  rn  e 
rename 
us  ta  tus 

?    *  n  a  m  e 


Token  definitions: 
class  id      class  usage 
keyword  phrase 

sp*  . 


def aul 
pr i  nta 


t  class 
ble  asc  i  i 


eol 


The  End  Of  Line  indicator. 


a    *  space  %  t    a    b lank 


sp 
//ebl 
#<eol> 
<eol> 
#<sp> 
#sp 
<sp> 
#<sp*> 
//sp* 

<sp*>  an    arbitrary    number    of    *spa 

/^printable    ASCII 
//ASCII 

<printable    ASCII>      —   The    characters 
U c I  a s  s    id 
#<classid> 
tt  c  las  s-  id 
ft  <c la  ss -id> 

<class    id>      —   A    printable    ASCII    stri 
nor    commas.       It    serves    as 
//def  au  It    class 


ces'/  blanks 


with  octal  values  040->0126 


ng  containing  neither  blanks 
label  for  a  specific  CLASS. 
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#<def au L  t  c  L  3ss> 
#def au It-class 
#<def ault-c tass> 
<Def aul t  c  lass> 

--  Certain  Non-Class  commands  (R 
are  mapped  into  their  corresp 
characteristics  found  under  t 
0  keyword  phrase 
#<keyword  phrase> 
^keyword- phrase 
#<keywo rd -phrase> 
<keyword  phrase> 

--  A  printable  ASCII  string 
<kpyword>/  a  seperator  ( 
<keyword  value>. 
=-  <keyword>-<keyworc  value> 
==  <keyword>  =  <nu  I  I  > 

A  'null'  value  indicates 
is  to  be  used. 

#  c  I  a  s  s  usage 

#  <  c  I  a  s  s  us  a  q e  > 
#cl ass-usage 
#<class-usage> 

<  c  I  a  s  s  usape>  ==  <class  id> 

==  <class  id>/<ident> 
—  Used  with  commands  requiring  the 
data  source/sink  via  an  explicit  CL 
suffice  when  the  Class  definition  d 
H  a  b  o  r  t 
ABORT<eol> 
#*abort 

ABORT  —  This  command  stops  any  tra 
accepted  as  a  command  at  a 
error  message  if  no  transf 
resets  the  transfer  parame 
Unix  system, 
ffbyte 

BYTE  <Decimal  /<><eol> 
#*byte 

BYTE  <Decimal  lt>         —  This  value  is  s 
rejects  the  value/  an  attempt 
hosts  at  BYTE  8  before  *  r  e  t  u  r 
#def i  ne 

DEFINE  <class  id>/<?><eol> 
--  Note  particularly  the  */ 
absence  of  this  generates 
#*def  i  ne 

DEFINE  <class  id>,<?> 

--  Establishes  a  DEF1  at  the  *  fore  ion 
the  syntax  of  the  post-<class  id>  f 
dependent.   I'se  other  documents/  or 


ENA/DLLE/APPF.  /RETR) 

on ding  Class  version/  using 

he  C  lass -Id:  *Def aul t  '  . 


beginning  with  a  valid 
=  ')/  and  an  optional 


that  the  def au I t -va I ue 


specification  of  a 

ASS.   The  short- form  will 

oes  not  require  an  <ident>. 


nsfer  in  progress.   It  is 
nytime/  but  may  generate  an 
er  was  in  progress.   It 
ters  to  their  defaults  on  a 


•  after 
bizarre 


ent  to  each  site.   If  either 

is  made  to  reconcile  the 
ni  ng  '  . 


the  <c  la  ss  i  d>  --  the 
<c  las  s  i  d>  '  s  ! 


1  site.   However/ 
ields  are  site- 
HELP  DEFI  for 
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further  information.   The  argument' 
replaced  uy    a    blank  (*  ')  and  then 
with  the  server  DfcFI  command. 
//delete 

DELETE  ULE  <  f  i  I  ename  ><eo  l> 
DELETE  IDENT  <class  id><eol> 
DELETE  IDENT  <class  i d >/ <i den t ><eo I > 
//•delete 

DELETE  FILE /ID  E  N  T  <filename>/<class  i 
--  This  cor-mand  sends  a  DELE  to 
specified/-  or  DELI  if  IDENT  wa 
need  for  */<ident>*  is  determi 
//descr  i  be 
DESCRIBh<eol> 
DESCRIBE  <class  id><eol> 
#*des  cr  i  be 
DESCRIB£C  < class  i d > 3 

—  Any  argument  is  sent  inta 
the  argument  to  a  DESC  co 


s  leadi  ng  *  r  *     is 
pa  ssed  in  ent  i  re  t  y 


d>Cr<ident>D 

the  Foreign  site  if  FILE  was 
s  liven.  If  the  latter/  the 
ned  by  the  class-definition. 


ct  to  the  Foreign  host  as 
rr i  in  a  n  d  . 


//fetch 

FETCH 
FETCH 
FETCH 
FETCH 
//*fetch 


FILE  FILE 
FILE  IDEMT 
IDENT  IDE  NT 
I D  E  N  T  FILE 


loca  I 

<fi I  e  n  a  m  e  > 
<f  i I ename> 
<class  u  s  a  g  e  > 


fore  ign 
<f  i  lenameXeo  I  > 
<class  usaoe><eol> 
<class  usage><eol> 
<class  usage >  <filenameXeol> 


FETCH 
FETCH 
FETCH 
FETCH 


FILE  FILE 
FILE  IDENT 
IDENT  IDENT 
IDENT  F  I  L  b 


local  fore 
<filename>  <file 
<f  i lename>  <c las 
<class' usage >  <clas 
<class  us?.ge>  <file 

—  Acquires  data  from  the  foreign 
site.   The  first  two  fields  of  t 
the  use  of  the  third  and  fourth 
is  mandated/  the  need  for  an  <id 
the  class  definition  at  the  asso 

//fmp  ass  word 

FKPASSW0RD<eol> 

//*f  mpas  sword 

FMPASSWORD      —  File  Ma sked -Pas s wor 

—  This  is  an  extension  of  the  FP 
returns  with  a  prompt  for  the  pass 
the  tty-echo  option  inverted.  Thi 
words  on  most  terminals  and  on  ECH 
result  is  sent  as  an  FPAS  argument 
self-echoing  terminals/  this  will 
command  .  ) 

U f pas  swo  rd 

FPASSWORD  <printable  ASCIl><eol> 

//*f  password 

FPASSWOKD       —  File  Password 


i  qn 

nameXeo  I > 
s  usage><eol> 
s  usage><eol> 
name  Xeo  I  > 

site  for  use  at  the 
he  argument  are  rude 
fields.   If  a  <class 
ent>  sub-field  is  implied  by 
ciated  site. 


local 
keys  to 
u  sa  oe> 


ASSWORD  command.   It 
word/  and  accepts  it  with 
s  will  mask  the  file  pass- 
0 -option  listings.   The 

to  the  foreign  host.   (On 
be  a  futile  -  but  amusing  - 
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b1 


--  The  argument  supplied  is  sent  with 
site.   This  is  irrelevent  on  Unix  sites 
file-specific  passwords). 
Refer  to  tMPASSWORD  for  an  alternative'/ 

tfldefine 

L  b  fc  F  I N  E  <cUss  id>/<?><eol> 

—  Note  particularly  the  "/'  after  the  < 
absence  of  this  generates  bizarre  <clas 

d* Idef i  ne 

LDEFIf.E  <ctjss  id>/<?> 
— Establishes  a  DFF1  at  the  'local*  site 
the  syntax  of  the  post-<class  id>  fields 
dependent.  Use  other  documents/  or  LHEL 
further  information.  The  argument's  lea 
replaced  by  a  blank  ( *  ')  and  then  passe 
with  the  server  DEFI  command. 

Wide  I  etc 

LDELETC  FILE  <  f  i  I  ermine  ><eo  I  > 

LDELETE  IDENT  <class  id><eol> 

LDELETE  IDENT  <class  i d>, <i de nt >< eo  I  > 

n  *  I  d  e  I  e  t  e 

LDELETE  F-lLfc/IDENT  <  f  i  I  ename>  /<  c  I  a  s  s  id>C/ 

--  This  command  sends  a  DELE  to  the  *loc 

specified/  or  DELI  if  I D E N T  was  given. 

need  for  */<ident>*  is  determined  by  t 

it  Id  escribe 

LDESCRIBE<eol> 

LDESCR1BE  <  c  I  a  s  s  id><eol> 

#  *  I  describe 

LDESCRIbEC  <class  id>3 

—  Any  argument  is  sent 
as  the  argument  to  a 

U  I  fmpas swo  rd 

LFHPASSVORD<eol> 

H*  If mp a s sword 

LFMPASS'-'ORD      —  File  Ma  s  ke  d-  Pa  s  s  wo  rd 

—  This  is  an  extension  of  the  LFPASSW 
returns  with  a  prompt  for  the  password/ 
the  tty-echo  option  inverted.  This  wil 
words  on  most  terminals  and  on  ECHO-opt 
result  is  sent  as  an  FPAS  argument  to  t 
self-echoing  terminals/  this  will  be  a 
comm  and . ) 

#lf password 

LFPASSWORD  <printable  ASCII><eol> 

//  *  I  f  pas  swo  rd 

LFPASSWORD       —  File  Password 

—  The  argument  supplied  is  sent  with 
site.  This  is  irrelevent  on  Unix  sites 
file-specific  passwords). 

Refer  to  LFMPASSWORD  for  ,->n  alternative/ 


FPAS  to  the  More 
(where  there  are 

masked  method. 


class  id>  - -  the 
s  i  d>  's  ! 


howeve  r  * 
are  site- 
P  DEFI  for 
d  i  n  ;)  *  /  *  is 
d  in  entirety 


i  'in 
no 


<  i  d  e  n  t  >  1 

a  I  *  site  if  FILE 
I  f  the  lattery- 
he  class -definiti 


was 
the 
on  . 


intact  to 
DESC  comma 


the 

nd  . 


'local'  host 


ORD  command.   It 

and  accepts  it  w 
I  mask  the  file  p 
ion  listings.   T  h 
he  f  o  re  i  'in  host  . 
futile  -  but  amus 


ith 

a?s- 

e 

(On 
i  n  y  • 


FPAS  to  the  ' loca 
(where  there  are 

masked  method. 


I' 

no 
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tf  I  I  o  g  i  n 
U  l  logon 
LLOuON 
or 

L LOGIN 
L  LOGIN 
L LOGIN 
L LOGIN 


<host  conn  spec  '><eol> 

<host  corm  s[.ec'>/<user  ident><eol> 

<host  conn  si;ec'>/<user  ident>r<password  sj.ee' ><eol> 

<host  co rm  spec'>/<user  ident>/<passwcrd  spec'>* 

<acct  i  nf  oXeol  > 
: :=  <print able  ASCI  1> 
or   <printabLe  A  S  C  I  I>  |  <d  ec  i  ma  I  //> 
a  f I  a  j 

it>    is  a  non-standard  ]CP  socket. 
: :=  <print able  ASCI  I> 
<nul  I  st  r i ng> 
<printable  ASCII> 
i 

<nul  l> 

where  *!'  prompts  for  another  line  bearing  the  password 
and  attempts  to  mask  this  (refer  to  L  MP  ASS) 
::=  <p.rintablc  ASC1I> 
or   <null> 


<host  conn  s  p  e  c  '  > 

where  * | *  is 
and  <  d  e  c  i  m a  I 

<user  ident> 

<p ass  word  spec  *> 


or 

or 
or 


<acc  t  i  nf o> 


#*llogin 
#*  I  logon 
L LOGON 
or 
LLOGIN 


—  Establishes 
'local*  site. 


command  connection 
( I  e  •  establishes  a 


for  the  psfudo- 
menage  a  t  r oi  s  *  . ) 


Makes  a  connection'  attempt  to  the  specified  site  and*-  if 
successful  passes  on  the  specified  fields  with  their  associ- 
ated Server  commands:   (USER,  PASS/-  &  ACCT).   Null  fields 
inhibit  the  sending  of  their  Server  command.    (The  distant 
site  must  be  able  to  Ion  a  user  without  requiring  such 
things  as  nu  1 1 -pass  words . ) 


The 
res 

f}  loi-in 

tt  louon 

LOGON 

or 

LOGIN 

LOGIN 

LOGIN 

LOGIN 


*!'  option  in  the  password  field  provides  a 
tricting  publication  of  passwords. 


handy  way  of 


host  conn  spec  '><eol> 

host  conn  spec'>/<user  ident><eol> 

host  conn  spec'>/<user  ident>/<password  spec'Xeol> 

host  conn  spec'>*<user  ident>/< password  s  p  e  c  '  >  • 

<acc t  i  nf  o><eo  l> 
<host  conn  spec'>  ::=  <printable  ASCII> 

or   <printoble  ASCII>|<decimal  ti> 

a  flag 

#>  is  a  non-standard  ICP  socket. 


where  * | '  is 


and  <decimal 
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or 

•  • 

or 
or 


<user  ident>       ::=  <printable  ASCI1> 

<nu  L  L  s t  r  i  ng  > 

<password    spec*>       ::=    <printable   'ASC1I> 

i 

<nul  l> 

where  *!•  prompts  for  another  line  bearing  the  password 
and  attempts  to  mask  this  (refer  to  M  P  A  S  S  ) 
<acct  info>        ::=  <printnble  ASCII> 

or   <nu  I  l> 
//*  log  i  n 
ti  *  I  o  g  o  n 
LOGON 
or 
LOGIN  - -  Establishes  a  command  connection  for  the  "foreign'  site 

Makes  a  connection  attempt  to  the  specified  site  and/  if 
successful  passes  on  the  specified  fields  with  their  associ- 
ated Server  commands:   (USER/  PASS/  &    ACCT).   Null  fields 
inhibit  the  sending  of  their  Server  command.    (The  distant 
site  must  be  able  to  log  a  user  without  requiring  such 
things  as  null-passwords.) 


The  '  ! 
rest  ri 
masked 
be  t  ra 
U  I  m  p  a  s  s 
LMPASS<eol 
U  I rdef  i  ne 
LRDEFINl  < 
#* l rdef  i  ne 
LRDEFINE  < 
--  Alters 
The  synt 
depend en 
fur  the  r 
rep  I aced 
with  the 
ti I  rename 
L RENAME  FI 
L RENAME  ID 
#* I  rename 
LRENAME 
-  -  A 1 1  e  m  p 
The  ar 
RENI/R 
specif 
tl  Istatus 
LSTATUS<eo 
LSTATUS  <p 
//♦Istatus 


1  option  in  the  password  field  provides  a  handy  way  of 

cting  publication  of  passwords.   The  prompt  for  the 

password  will  NOT  occur  until  the  PASS  command  is  to 
nsmitted. 


class  id>/<?><eol> 

class  id>/<?> 

a  class  definition  at  the  'local1  site. 

ax  of  the  post-<class  id>  fields  are  site- 

t.   Use  other  documents/  or  HELP  RDEF  tor 

information.   The  argument's  leading  */'  is 

by  a  blank  ("  *)  and  then  passed  in  entirety 

server  RDEF  command. 

LE  <filename>  <filename> 

ENT  <classid>/<ident>/<ident> 


ts  to  rename  the  specified  file  at  the  'local'  site. 
gument  is  broken  to  conform  to  the  requirements  of  the 
ENA  server  commands  (as  per  the  IDENT/FILE 
i  cat  i  on  )  . 

l> 

rintable  ASCIl><eol> 
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LSTATUS 

--  Passes  the  argument/  if  provided/  on  to  the  'local*  site. 

If  that  site  is  a  Unix  installation*  and  the  user  is  I  o  g  q  c  d  in 
there  and  not  transferring  data/the  argument  field  will  be 
used  .  *  s  a  pathname  in  a  directory  listing  (LS). 

#  rr  p  a  s  s 

MPASS<eol> 

#*npass 

H  *  I rop as  s 

MPASS   —  r-'asked  Passwd  (PASS)  sent  to  "foreign'  site. 

LMPASS  —  Masked  Passwd  (PASS)  sent  to  'local'  site. 

This  command  is  superlfluous/  insofar  as  the  lo;iin  sequence 
is  m e a n t  to  be  handled  via  the  LOGIN  or  LOGON  command. 
However*  should  the  user  choose  to  login  via  the  more  prosaic 
Server  commands/  this  command  assists  by  masking  the  password 
(via  inverting  the  tty-echo  mode)  and  keeping  the  password  out 
of  the  ECHO-option  listing.. 

#qui  t 

QUIT<eol> 

#*qui  t 

QUIT    —  Immediately  cease  any 
command  connections  and 

P rdef  i  ne 

RDEFINF  <class  id>/<?Xeol> 

#*rdefine 

RDEFINE  <class  id>/<?> 

—  Alters  a  class  definition  at 
The  syntax  of  the  post-<class  id>  fields  sre    site- 
dependent.   Use  other  documents/  or  HELP  PDEF  for 
further  information.   The  argument's  leading  */'  is 
replaced  by  a  blank  (*  ')  and  then  passeo  in  entirety 
with  the  server  RDEF  command. 

fl  rename 

RENAME  FILE  <filename>  <filename> 

RENAME  ILENT  < c I  a s s i d > / < i d en t >/ < i den t > 

tf  *r  ename 

RENAME 

—  Attempts  to  rename  the  specified  file 
The  arqument  is  broken  to  conform  to  the 


ongoing  transfer/  then  close  all 
return  the  user  to  the  system. 


the  *  t  o  r  e  i  •:,  r.  J  site. 


at  the  'foreign'  site, 
requirements  of  the 


REN1/RENA 
#send 


server  commands  (as  per  the  IDE  NT/FILL  specification). 


SEND  FILE  FILE 

SEND  FILE  IDENT 

SEND  IDENT  IDENT 

SEND  IDFNT  FILE 
#*f et ch 

STND  FILE  FILE 

SEND  FILE  IDENT 

SEND  IDENT  IDENT 


local  foreign 

<filename>  <filenrjme><eol> 

<filer.ame>  <  c  I  a  s  s  usaqe><eol> 

<class  usage>  <class  usage><eol> 

<class  usage>  <filen3mc><eol> 

loce  I  tore  i  gn 

<tilename>  <filename><eol> 

<filename>  <class  usage><eol> 

<class  u s a g e >  <class  u  s  a  o  e  X  e  o  I  > 
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SEND  IDLNT  FILE    <  c  I  a  s  s  u  s  a  g  e  >  <tilename><eol> 

--  Acq u ires  data  from  the  local  site  for  use  at  the  fort 
site.  The  first  two  fields  of  'the  argument  are  rude  ke 
the  use  of  the  third  arid  fourth  fields.  If  a  <class  us 
is  mandated*  the  need  for  an  <ident>  sub-field  is  impli 
the  class  definition  at  the  associated  site. 

//status 

STATU  SO;  ol> 

STATUS  <printable  ASCII><eol> 

//♦status 

STATUS 

-  Passes  the  argument*  if  provided*  on  to  the  'foreign'  si 
If  thit  site  is  a  Unix  installation*  and  the  user  is  logge 
there  and  not  transferring  data*  the  argument  field  will  b 
used  as  a  pathname  in  a  directory  listing  (LS). 

//toggle 

TOGGLE  BLOCKED<eol> 
TOGGLE  ECH0<eol> 
TOGGLE  PROv.PT<ool> 
TOGGLE  SUICIDE<eol> 
#*togqle 

TOGGLE   BLOCKED  |  ECHO  |  PROMPT  |  SUICIDE 
--  Toggles  state  of  supplied  boolean.   (Only  one  may  be  tog 
per  command.) 
BLOCKED    —  <def ault=0FF> 

-  Upon  initiation  of  JO  (St.  ND/  FETCH)*  further  commands  are 
sought  until  transfer  terminates.   ...For  file-driven  FTP 

ECHO       —  <def ault=OFF> 

-  Results  in  input  lines  being  echoed  back.   ...For 
file -driven  FTP*  to  create  Trace -file  on  standard 

PROMPT     —  <default=ON> 

-  Toggles  prompting  *:  '  which  appears  when  command 
...There  is  no  known  reason  to  turn  it  off. 

SUICIDE     —  <detault=OFF> 

-  Results  in  self-extermination  upon  any  non-acceptable  Axx 
response.   (The  acceptable  ones  being  on  CONN  or  ABOR.) 


i  gn 
y  s  to 
a  g  e  > 
ed  by 


t  e. 
d  in 

e 


g  led 


NOT 


use  with 

output . 

is  awaited 


others  "exist 


-5  xx 
but  are  unreleased  due  to  uncertain 


Several 

value! 

//type 

TYPE  A<eol> 

TYPE  Keol> 

TYPE  P<rol> 

//*type 

TYPE  A|1|P   —  The  transfer  type*  as 
An  attempt  is  made  to  send  the 
on  failure  in  either  attempt*  a 
Upon  ANY  transfer  attempt*  the  value  is  reset  to 
except*  sometimes*  on  errors  (sigh). 

tfustatus 

USTATUS<eol> 

USTATUS  <printJble  ASCII><eol> 


per  PlATFOkM 
parameter  to 


FTP  spec's 
each  site* 


but 


TYPE  A •  is  sent 


to  each 
'  A  •  .  .  . 
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#*ustat 
USTATUS 

-  User- 
trans  f 
otherw 
is  not 
p  a  t  h  n  a 

#mai  I 
MAIL  <A 
KAIL  <A 
#*mai  L 
MAIL  <A 

-  User 
or  "roo 
"MAIL  < 
mode. 
to  the 


us 

FTP  STATUS.   The  equivalent  of  LSTATUS  during  a  two-party 
er/  or  info  on  both  the  ps eodo-  lo c a  I  and  foreign  sites 
ise.   If  an  argument  is  provided/  and  the  U  s  e  r  -  t  T  P  program 

currently  transferring  data/  the  argument  is  used  as  a 
me  in  a  directory  listing  (LS). 

RPA-standard  Text  filenarne>/<rccipient><eol> 
R  PA -standard  Text  filenarne><eol> 

pPA-standard  Text  filename>Cr<recipicnt>3 

(source)  Mail-sending  command.   Only  executable  by  "bin" 

t"/  this  code  effects  a  local  "RETR"  and  a  foreign 

rec i pi  en t >" .   It  cannot  be  executed  in  Three-party 

The  "user"  is  expected  to  h3ve  alreaay  performed  a  "LOGON" 

desired  site. 
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Appendix  C:   User  'HELP'  Text 


**************************************************************** 
***    This  tile  is  the  IIELP-text  for  the  server-interface  code 
***   of  the  PLATFORM  FTP.   It  is  accessed 
***   HELP  command.   The  Appendices  of 
***   shrill  also  include  a  copy  of  this 


in  that  code  via  the 
the  PLATFORM  uocumentation 


ti int  ro 

Help  provides  assistance  in  2 
help  COMMAND    —  provides 
help  *COv;''.AND   —  provides 
blanks  between  tokens  on  the 
required;  they  are  the  equiv 
a  I  way  stripped  from  the  begi 
•field-separators  (  "  ■  r     *  =  *  * 
number  of  blanks  (<sp*>). 
Also: 

help  commands   --  lists  the 

help  in 
U commands 

The  details  on  which  there 

Commands  to  Server  FTP: 

abo  r        acct         a 

defi         dele         d 

help         inpu        n 

pasv         quit         r 

retr        sock        s 

"mail"  is  implemented  as 

For  syntax/-  type:  HELP  nam 

Token  definitions  : 

class  id     default  class 
'  print  able  ASCI  I       sp 
#eol 

<eol>       The  End  Of  Line  in 
#sp 

<sp>       a  'space'/  a  blank. 
#sp* 

<sp*>      an  arbitrary  number 
ti printable  ASCII 
<printable  ASCII>   —  The  cha 
H c lass  id 
<class  id>  —  A  <printable  AS 

nor  commas.   It 
//default  class 
<Default  class> 

—  Cert h in  H on-Class 
mapped  into  their  cor 
characteristics  found 
//keyword  phrase 
<kcyword  phrase>   --  A  <print 


primary  ways: 
the  command  syntax, 
an  explanation  of  the 

Syntax  Lines  are  if,  e  a 
alent  of  <  s  p  *  > .  Plan 
nning  of  fields/-  so  m 
■ r  ' )  can  be  followed 


command. 
ningful  arid 
ks  are  nearly 
ost 
oy  an  arbitrary 


commands  (and  some  'tokens')  having 
fo. 


ere    help  modules  are: 


ppe 
eli 
oo  p 
def 
tat 


byte 
desc 
outp 
rena 
type 


a  pre-login  command, 
e   For  Description/  t 

eol     keyword  phr 
sp* 

d  i  c  a  t  o  r  . 


conn 
f  pa  s 
pas  s 
ren  i 
user 

ype:  HELP  *  n  a  m  e 

ase 


of  *  spa  ce  s  */•  blanks 

racters  of  the  octal 

C  1 1  >  string  containin 
serves  as  label  for  a 


values  040-0126. 

neither  blanks 
specific  CLASS. 


commands  (REN  A/DELE/A 

responding  Clu.ss  vers 

under    the    Class-Id: 


PPE/PFTR)     are 
ion*    using 
'Def aul t ' . 


able    ASCH>    string    bejinning    with    a 
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Text 


valid  <keyword>/- 
optional  <keywor 

==  <keyword>=<keyword  vatue> 

==  <keyword>=<null> 

A  'null*  value  i 


a  separator 
d  v  a  I ue>  . 


(*=•)#  and  an 


ndicates  that 
def aul t- va lue  is  to  be  used. 


the 


abort  its  current  transfer. 


#abor 
ABOR<eol> 

#*abor 

ABOR    —  command  to 
at  any  time. 
#acct 

ACCT  <printable  ASCIIXeol> 
#*acct 

ACCT    --  An  ignored  command*  irrelev 
tf  a  p  p  e 

APPE  <f i  lename><eol> 
U  *  a  p  p  e 

APPE    --  Opens  an  APPEnd  (receive  ne 
tfbyte 

^YTE  <Decimal  //><eol> 
#*byte 
BYTE  <Decimal  i?> 

Transfer  byte-size:     0<ti  <2b6* 
#  conn 

CONN*  <decimal  number><eol> 
#*conn 

CONN  <number> 
—  Requests  that  data  be  transferred 
connections:   UNIX  Server  ftp  rest 
v  a  I  u  °  to  3 ,    UNIX  User-ftp  restrict 
minimum  value  is  1. 
frdef  i 

DfcFI  <class  i d>  <keyword  phrase>/.../ 
—  Note  particularly  the  *  '  after 
the  primary  discrepancy  with  the 
and  traps  numerous  errors. 
#*def  i 

DEFI  <class  id>  <keyword  phrase>/.../ 

Creates  a  class-specification 

referenced  by  the  name;  <cl 

is  mr>de  via  <keyword  phrase 

destroys  all  trace  of  user- 

An  exist  ant  <class  id>  is  ent 

syntactically-acceptable  DE 

ft  d  e  I  e 

DELE  <f  Uenome><eol> 
#*dele 

DELE  <filename>    --  Attempts  to  dele 

us  i  ng  the  <De  f au 
tfdeli 


ant  to  UNIX  logons 


twork  data)  connection 


(rf    modulo  8)  must  t)e  Zero. 


over  multipl 
ricts  the  max 
s  its  maximum 


<ke  y word  p  h  ra 
the  <class  in 
USLR-interfac 


<keyword  phra 
which  can  th 
ass-id>.  The 
>'s.  Re-logg 
specified  cla 
irely  ob  liter 
FI  using  the 


e  dat  a- 
imum  va  lu  e 
to  2  .   The 


s e  ><  o o  I  > 

>  —  this 

e  command 


l  s 


s e  >< e o I > 

e  rea  f  te  r  be 

specification 
i  n  g  in 
sses  . 
a  t  e d  by  a 
same  id'. 


te  the  supplied  filename/ 
I t >  class. 


PLATFORM  FTP 
App.  C:   SI  Kelp 


89 


Text 


DELI  <class  id><eol> 

DELI  <  c  I  a  s  s  i  d  >  <idcnt><eol> 

#*deli 

DELI  <class  id>C  <ident>] 

—  file  delete...  usually  requiring  a 
possibly  no  (if  the  Class  definition 

ti  d  c  s  c 

DESC<eol> 

DESC  <class  id><eol> 

#*desc 

DESCC  <class  id>3 

—  'foreign*  server  command  which  ins 
definitions  (if  NO  argument  is  given) 
specification  of  the  Class  requiremen 
Class  Id  matches  the  argument. 

ti  i  pas 

FPAS  <printable  ASClI><eol> 

ti  *  f  f  a  s 

FPAS   --  Normally  reserved  for 
password.   This  concept 

command  is  ignored. 

#help 

HELP<eol>  —  for  an  introdu 

HELP  <hclp  id><eol>       —  for  help  on  on 

A'*  help 

HELP     --  searches  the  implied  help-file 

HELP  <help  id>    —  searcnos  the  implied  h 
beginning  with  a  '.*/  and  ha 
<help  id>  on  it  thereafter. 
until  another  line  beginning 
the  lines  are  returned  to  th 


n  I  dent  field/  but 
gives  a  complete  path). 


tructs  server  to  list 

or  a  detailed 
ts  if  a  (single) 


indicating 

is  alien  to 


a  specific  file's 
UNIX  and  the 


cto  ry  note 

e  specific  matter. 

for    the     *intro'     entry. 

elp-file    for    the     line 

ving    only    the    string 
From    the    next     line    on/ 
with     *.*    or    until     <eof> 

e    user  . 


ti  i  npu 

INPU  <class 
INPU  <class 
ti*  i  npu 
INPU 


id><eol> 

id>  <ident><eol> 


<class  i  d  >  C  <ident>D 

—  Requests  that  a  network  INPU  (data 
be  established.  The  <class  id>  indie 
definition  characterizing  the  transfe 
turn  mandates  the  requirement  for  the 

ti  noop 

NOOP<eol> 

NOOP  <printoblo  ASCIl><eol> 

ti  *r.oop 

NOOPC  <printable  ASC1I>] 

—  An  ignorable  command  requesting  only  an 
existential  affirmation.   (" Respondeo *  eroo 
propter  sum.") 

ti  outp 

OUTP  <cl^ss  id><eol> 

OUTP  <class  id>  <ident><eol> 


-emit  TO  net) 
a t  e  s  the 

r  /■  which  in 

<  1  d'e n t >  field 
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/Moutp 

OUTP  <class  id>[  <ident>] 

-r  Requests  that  a  network  OUT P.  (data-receive  FROM 
net)  be  es  tab  I  i  s  heu .   The  <class  id>  indicates  thp 


transfer/  which 
lor  the  <ident> 


definition  cha rac t er i z  i n  \    the 

turn  mandates  the  requirement 
U  p  as  s 
PASS<eol> 

PASS  <printable  ASCII><eol> 
//♦pass 
PA SSL  <printable  A  S  C 1 J  >  3 

—  The  Logon  password  for  the  USCR  id'.   This 
limited  in  two  ways:   PLATFORM  FTP  limits  one 
accepting  only  printable  ASCII;  and  the  FTP 
scanner  strips  off  both  leading  and  trailing 
blanks  from  all  argument-lines. 

PASS  is  NOT  required  for  accounts  which  are 
not  password  protected, 
tfpasv 
PASV<eol> 
U  *  p  a  s  v 
PASV 

—  The  Passive  command  sets 
mode  on  the  next  transfer's 
if  one  somehow  gets  BOTH  sites  into  a  passive 
had  better  tine-out  as  this  FTP  does.)   It  is 


l  n 
field 


i  s 
to 


the  ftp's  state  into 
connection  attempts. 


a  listening 
(Thus/ 
state/  they 
reset  with 


each'  transfer/  or  with  an  ABOR.   There  is  "*G  snalooous 
command  to  specifically  make  an  FTP  Active, 
tfquit 
QUlT<eol> 
#*qui  t 
QUIT       —  On  receipt/  the  FTP  is  to  abort  any  ongoing  transfer 

and  close  the  command  connection. 
tfrdef . 

RDEF  <class  id>  <keyword  phrase>/.../<keyword  phrase><eol> 
#*rdef 
RDEF  <cUss  id>  <keyword  phrase>/.../<keyworri  phrase> 

Alters  a  class-specification  which  can  thereafter  be  referenced 
by  the  name:  <class-id>.   The  specification  is  made  via 
<keyword  phrase>'s.   Re-logging  in  destroys  all  trace  of  user- 
specifien  classes. 
To  be  altered/  the  <class  id>  must  already  exist. 
#  rena 

old        new 
RENA  <filen.jme>  <f  i  I  enar  e><eo  I  > 
# *  r  e  n  a 
RENA  <filename  old>  <filename  new> 

This  command  results  in  a  file  being  renamed  by  the  cumbersome 
technique  of  copyino  it  and  then  unlinking  the  old  version. 
Thus  t he  re  are  several  broad  implications  on  a  UNIX  system: 
There  must  be  space  available  for  a  duplicate  on  the 
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referenced  file-system;  there  must  be  no  obligation  that 
the  new  file  share  the  old's  inode  number. 
ti  r  e  n  i 

old      new 
RENI  <c lass  id>  <ident>  <i den t><eol> 
#  *  r  e  n  i 
RENI  <  c  I  a  s  s  id>  <old  i  d  e  n  t  >  <new  ident><eol> 

This  command  obliges  the  specified  I D  t  f  J  T  under  the  given  CLASS 
to  be  renamed.   The  technique  used  is  to  actually  make  a  coj  y  of 
the  file  then  remove  the  old  version.   Refer  to  REN A. 
ffretr 

RETP  <f  i  leni.me><eol> 
ti*ret  r 
RETR    --  Requests  the  establishing  of  a  network  connection  in 

which  a  local  file  will  be  transferred  onto  the  net. 
#sock 

SOCK.  <host  id>  <decimal  socket  number><eol> 
#*soc  k 
SOCK  <hnst  name>  <socket  1l> 

Sock  redefines  the  distant  host  and  socket  for  the  next 
transfer . 
The  acceptable  ranges  are: 
C  <  host  name  <  25  5 
.  • .  or  a  valid  name 
7  <  socket  ti    <  2**32  -1 
ti  s  t  a  t 
STAT<eol> 

STAT  <printable  ASClI><eol> 
#*stat 

STAT  --local  status  info* 

STAT  <p=thname>    —  information  on  the  specified  file 
ti  t  y  p  e 

TYPE  A<eol> 
TYPE  Keol> 
TYPE  P<eol> 
ti  '*  t  y  p  e 

TYPE  A  J  I | P   --  The  transfer  type/  as  per  PLATFORM  FTP  spec's. 
ti  user 

USER  <printable  ASCII><eol> 
ti *use  r 
USER  <user  id> 

--  The  login  ident  for  the  desired  account/  limited  by 
leading  and  trailing  d e b  I  a  n k  i  n .j  /•  and  by  the  PLATFORM 
FTP  limit  to  printable  ASCII. 
#mai  I 

MAIL  <recipient><eol> 
MAJL<eol> 
#*mai  I 
KAIL  <recipient> 

—  Executable  only  by  "super  users"  --  hence/-  only 
prior  to  logging  in  —  this  command  informs  FTP  to 
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await  the  transfer  of  an    ARPA-S t andard  Text  message 
which  is  to  be  delivered  by  MS.   The  absence  of  a 
recipient  field  indicates  the  mail  is  to  be  delivered 
to  the  user  "root". 


CONN  arbitration  will  NOT  be  performed  --  it  will 
def au  1 1  to  1  . 
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Appendix  D:   FTP  Notes 

The  following  notes  are  miscellaneous  observations  regarding   the 
PLATFORM  FTP  codes. 


On  Sequenci 
Gi  ven 
A80R/N 
chance 
i  m  p  I  e  m 

1-  Al 
return 
user-p 
S  e  n  d  i  n 
trans  f 
ABOR/N 

2-  Mo 
confus 
comman 
NOT  b 
reply 
and  ca 


ng  and  Cedes: 

the  overlap  between  transfer  ope  rat 
OOP/STAT   commands   it   is  imperative  that  t 

for   confusion.     My    code    presumes 
entations  obey  the  following  rules  strictly: 
I  transfer  commands  will  result  in  a  *  1 0  0 '  r 
e  d   prior   to   settling   into   a  connection 
rogram  CAN   (and   does)   await   this   res p on 
:;   the   second   site   its  commands  with  resp 
?r/  but  NUST  await   this   response   before 
OOP/STAT  commands  to  be  sent. 

transfer  re fly  sent  AFTER  the  *  1  0  0  '  respons 
tible  with  legitimate  responses  to  the  A  b  0  R 
ds  .  Specifically/  the  *500'  and  '306*  rep 
e  sent  regarding  the  transfer  request  AFT 
has  been  given  on  it.  (Obviously  a  '421*  is 
lis  for  but  one  response.) 


ions  and 
here  is  NO 
that    all 

•  ■  p I y  being 
wait.  The 
s  e  before 
ect  to  the 
pe  rmitting 

e  can  be 
/NOOP/ STAT 
lies  must 
FR  a  •10b' 
sendab  I  e 


On  Chancing  Com pi  led -In  'CLASS*  Definitions: 

Compiled-In  (System-  or  Universal-standard)  class 
definitions  will  ideally  NOT  contain  syntactic  errors.  But 
of  cOu rse... . 

The  easiest  way  to  check  for  such  errors  is  to  ask   for 

a   DESC  on   its   particular  <class  id>.   (A  OESC  bearing  NO 

argument  will  merely  list  the  defines/  and  not  syntax  check 
them. ) 

"DESCRIBE  classid 


The  above  should  therefore  be  run  on  C3ch  modifiea  or  added 
class  before  the  new  version  is  released.  Should  a 
definition  error  be  comp  i  I  ed-i  ri/  multiple  error  messages  may 
arise  on  attempting  to  use  it:  this  is  all  right  for  the 
user  scanning  the  text/  but  risks  havoc  with  algorithms 
attempting  to  make  sense  of  the  replies. 

Notes  on  type  ==  •  p  *  --  ASA  carriage  control  transfers 
I. 

The  local  file  is  treated  as  if  of  ASCII  type  with  standard 
Unix-ASCII  form  controls.  Thus/  a  file  transferrer d-in  with 
ASA  standards  must  undergo  two  examinations:  (1)  Anytime  the 
character  pair  <CR><Lf>  is  encountered  the  pair  is  thrown 
out  (without  any  replacement)  and  a  flag  is  set  such  the 
next  byte  will  be  treated  as  a  Carriage  Control.  (2)  If  a 
line  is  just  beginning  --  either  the  transfer's   first   data 
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byte   is   beiny  examined*  or  a  C 
—  the  current  character  is  t a k e 
effector.    The   only   recoqnu.? 
double-space  function  is  effecte 
(•0*)   with  two  <newline>S/"  the 
by  the  obvious  single  character 
is   unrecognized/'   an   internal 
for  luter  reference  and  the  cont 
character  sequence:  <ncwline><un 
II.    Anomalies: 

If  a  file  is  transferred  in  seve 
split  and  the  individual  parts 
files)  several  oddities  arise 
convention  for  storting  a  trans 
the  first  character  received  is 
carriage  control  coder  so  fi 
boundaries.  .Next/  a  generally  r 
that  text-lines  are  terminate 
make  the  received  file  terminat 
<n«iwline>  must  be  appended  t 
data.  Concatenating  two  transfe 
spurious  <newline>  in  the  midst! 
Ill  . 

If  an  NVT  line  consisting  of  sim 
this  is  clearly  lacking  an  ASA 
noted  in  the  above-mentioned  man 
still  examined  as  a  carriage  con 


R/LF  pair  were  just  observed 
n  to  be  a  carri  aije-con t  rol 
d  ones  are  +  /07<5b>/1.  The 
d  by  replacing  the  ASA  code 
other  functions  are  effected 
effectors.  If  the  ASA  code 
error  counter  is  incremented 
rol  is  replaced  with  the 
recognized  byte>?<newline>. 

ral  pieces   ( i  e  /   if   it   is 

are  transferred  as  separate 

first*   there    is    no 

fer  in  the  middle  of  a  line: 

always   presumed   to   be   a 

les   must   be  split  on  line- 

espected  Unix  convention   is 

d  with  a  <newline>:  thus/  to 

e   in   a   logical   manner   a 

o  the  end  of  the  transferred 

rred  files  would  result  in  a 


ply  <CRXLF>  is  encountered/ 
control  code.   The  error  is 
ner*  but  the   next   byte   is 
trol  code. 
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The   following 

improvement . 
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subjects   are   areas    where 


FTP 


could 


be  ar 


Anomalous  Error  Msg? 

1  find  it  hard  to  agree  with  the  use  of  the  *  4  2  2  *  error 
message  in  response  to  a  received  *ator'  while  NO  transfer 
is  pending.  One  problem  is  that  the  UI's  presumption  that 
PI  is  currently  transferring  data  may  be  correct  (on  the 
basis  of  available  data)  but  that  a  command  issued  on  this 
basis  may  be  incorrect  by  the  time  it  is  received  at  the 
Pi's  end  (because  of  transfer  delays).  Why  not  just  use  a 
*2xx*  code? 

Size  Considerations: 

This  cede  runs  with  22K  bytes  of  text/  and  another  9K  data 
while  docile.  Using  a  non  record-structured  transfer/  this 
blossoms  up  by  around  1  2  K  more  bytes.  The  sky  is  the  limit 
with  record-structured  10.  One  change:  reply  monitor  codes 
should  be  exee'ed  using  a  minimal  size  copy  program...  this 
will  release  the  fc  K  data  space  at  the  price  of  a  small/ 
sharable  text  segment.  Actually:  the  patch  should  be  to 
make  EMPTY  work  on  network  files —  then  there'd  be  no  need 
tor  the  copy  prog. 

However/  that  leaves  only  a  few  tens  of  thousands  of 
bytes  to  worry  about.  Several  thousands  of  bytes  of  data 
constants  (strings/  primarily)  cause  a  large  non- sharable 
burden.  It  would  be  ad v ant  a  go us  to  MOT  burden  the  transfer 
process  with  this  --  hence/  it  would  be  space-saving  to  make 
the  transfer  process  a  separate  code. 

Ul/PI^split 

As  discussed  in  many  other  places/  the  code  would  be  easier 
to  comprehend  if  the  local-Pi  were  driven  by  the  Ul  just  as 
the  foreign-Pi  --  except  that  pipes  would  be  used  rather 
t  h  *  n  Network  connections. 

DTP*spl it 

Virtually  all  the  LSS  and  DATA  space  of  FTP  would  be  dropped 
from  the  DTP's  swap ping -space  if  it  were  made  a  seperate 
code.  The  routines  which  the  DTP  shares  with  the  other  PI 
and  UI  codes  is  smaller  than  this/  and  data  space  in  non- 
sharable. 


N.ulti-Roply'Fix 

A  minor  bug  is  that  errors  in  compiled-in  class  definitions 
can  result  in  multiple  error -mess  ages.  This  is  *bad  form'/ 
even  if  it  reflects  carelessness  on  t  ho  re-compiler's  part. 
It  could  be  circumvented  with  additional  code. 
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Reductio'ad'Valutum 

The  ii  1  currently  ignores  the  goal  of  reducing  the  vcrboqe 
presented  to  the  'user'.  As  confidence  in  the  code  has 
developed/  it  begins  to  seem  reasonable  to  provide  a  switch 
which  would  enable  a  condesation  of  the  replies. 


Masked-Password" Update 

The  codes  which   mask 


passwords   are   only   functional   for 


term  in  rils  which  don't  handle  the  echoinq  themselves.  This 
code  can  be  extended  to  use  the  traditional  over -printed 
field/  or  any  other  mechanism  to  mask  even  echoing 
terminal's  output. 

/etc/wal I "messages 

Unix  users  are  currently  informed  of  impending  system 
problems  by  the  use  of  /etc/wall  messages.  FTP  could  be 
modified  such  that  these  would  be  relayed  by  the  Server  to 
its  command  connection. 

Command"Time  outs 

The  server  code  should  be  modified  to  timeout  after  some  set 
period  of  non-responsiveness  from  the  other  party.  (Clearly 
the  timer  should  .NiOT  be  running  while  a  transfer  is  running 
in  the  background.) 

Reset"on"Single-Side"Errors 

There  are  problems  with  achieving  agreement  between  the  two 
SI  after  errors  occur.  If  the  errors  are  recognized  by  both 
parties/  all  is  well.  However/  if  the  error  occur ed  at  only 
one  end  and  NOT  during  a  transfer/  then  the  two  parties  may 
no  longer  agree  in  their  parameters.  This  problem  is  more 
intuited  than  experienced...  but  it  probably  exists.  It  is 
also  another  argument  in  favor  of  implementing  a  RESET 
command/  similar  to  the  ARPA  Protocol's. 


Command" Connect  ion" ALLOC 

The  allocation  size  for  the 
probably  be  minimized/  given 
conne  ct  i  on  . 


command   connection   should 
the   low   bandwidth  of  th^t 


FTP'Exi t "Value 

Currently/  when  the  UI  code  'exits'  it  passes  the  value  of 
the  last  significant  reply  code  it  received.  This  number  is 
altered  to  fit  into  the  single  permitted  byte:  values  in  the 
200s  and  300s  map  into  zero;  values  greater  that  399  map 
into  1+<numbor>/  and  FTP  errors  map  into  - 1  .  This  code  is 
usable  to  indicate  whether  or  not  the  FTP  session  terminated 
on  an  error/  or  after  a  successful  operation.  The  major 
limitation  is  that  the  coce  can  only  range  from  0  to  255... 
whereas  FTP  could  use  a  field  several  times  that  size  to 
indicate   the   various  aspects  such  as  the  site  at  which  the 
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Apj.endix"F  :"NCP"Changes 

The  following  .ire  aspects  of  the  K'CP  that  have  a  negative  impact 
on  the  FTP  codes.  They  are  presented  in  one  place  to  encourage 
the  discussion  of  solutions  to  general  problems  in  the  Unix  rv  L  P  - 

N  C  P  "  *  E  rr.  p  t  y  ■ 

The  network  is  similar  to  pipes  and  teletypes  in  that 
"unsolicited*  data  may  arrive  at  any  moment.  While  the 
latter  two  have  an  'empty*  call  that  identifies  that  there 
is  no  available  data  awaiting  a  READ/'  the  NCP  lacks  this. 
This  function  is  necessary  for  FTP/  and  the  lack  of  the 
function  is  the  sole  reason  for  the  Reply  Buffering  process 
that  sits  between  the  Ul  and  the  reply  connections  from  its 
controlled  Server(s). 

Timeouts 

Currently^  ICP  connections  "timeout*  using  that  field 
of  the  parameter  list  to  identify  the  waiting  period. 
However/  the  offset-connection  attempts  do  net  timeout/  nor 
do  READ/ w'RITEs.  The  extension  of  timeouts  to  cover  those 
features  would  be  quite  useful  and  would  reduce  the 
obfuscating  barracade  of  alarm  and  time  calls  that  surround 
"properly  protected'  network  10. 

Filesystem'trror" Messages 

It  would  be  a  useful  extension  to  Unix  to  have  Pell 
Labs  define  and  reserve  certain  system-call  error-numbers 
that  would  reflect  Network-related  troubles:  Timeout  on 
connection  attempts/  inadequate  resources  to  open  the 
connection/  etc.  The  standardization  of  these  would 
facilitate  the  exchange  of  codes  and  would  result  in  better 
error -messages  being  made  available  for  the  users. 


